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ABSTRACT 

Operator's instructions and technical support 
materials needed for processing the M. E.T.R.O. r-APEX (Air Pollution 
Exercise) game decisions on an IBM 360 computer are compiled in this 
volume. M.F.T.R.O.-APEX is a computerized college and professional 
leveJ. "real world" simulation of a community with urban and rural 
problems, industrial activities, and air pollution dif faculties. . This 
manual takes the game operator from the worksheets filled out by 
players of the game through the complete card deck which must be 
submitted for computer input, in addition, it discusses the- various 
program options and utility support features of the M.E.T.R.O. rAPEX 
system. The computer program is in Fortran IV. A related document is 
ED 064 531 which presents the same computer operator's manuel for use 
on an IBM 1130-2B computer. (BL) 
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PREFACH 



The M.E.T. R.O.-APKX project anticipated by several years llu- lUitional 
concern for environmental problems which are now so mucli in vogue. 

The emphasis in M.E.T.R.O.-APEX is on air pollution (or more properly, 
training in air quality management). The context for this training is a 
metropolitan region designed to insure a more valid perspective for the 
technical training concurrently supplied than that normally achieved through 
conventional teaching techniques. 

The substance and nature of M.E.T.R.O.-APEX have been specifically 
designed for this task. Inspiration, and much technical input have c:oino 
from a similar exercise (M.E.T.R.O.) developed somewhat earlier at The 
University of Michigan. ^ 

The current version, M.E.T.R.O. --APEX, is the result of close and 
continuing cooperation between the COMEX Research Project, School of i^ublic 
Administration, The University of Southern California and the Environmental 
Simulation Laboratory, School of Natural Resources, The University of 
Michigan. The staff of both organizations have worked very ciosoiy 
throughout the project and share equally in any accolades or trauma that 
might result. 

One central task remains for the successful completion of the project:. 
The many potential users across the nation, and internationally (it has 
already been translated into French), will need special assistance in 
operationalizing the gaming-simulation on their home turf. Every effort 
has been made to make the exercise straightforward to operate. Nevertheless 
it is remarkably complex and special skills must be acquired for the game 
operators, the computer operators, and the role advisors; this is necessary 
with regard to both the general philosophy of use and the technical areas. 

The two institutions intend fco provide assistance to potential users 
to permit and encourage proper and frequent use of the exercise. 

Dr. Richard D. Duke, Director 
Environmental Simulation I.^boraiory 
School of Natural Resources 
The University of Michigan 
Ann Arbor, Michigan 
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Chapter 1 
INTRODUCTION 

This volume of the operator's kit contains the instructions and technical 
support material needed for processing the M.E.T.R.O,-APEX game decisions 
on an IBM 360 computer. 

♦ 

The 360 series of IBM computers includes a wide range of sizes, speeds 
and variety of peripheral equipment (card readers, printers, tape drives, 
disk storage units and other off-line storage devices). Despite this compLexiLy, 
no special skills in operating a computer or in computer programming are 
required to prepare M.E.T.R.O. -APEX player decisions for submission to tlic 
computer. Because of variations in Operating System control cards and in system 
configuration from one installation to another, the bas*ic sections of this 
manual are written on the assumption that the M.E.T.R.O.-APEX programs 
have been installed and are correctly operating at your computer installation. 
Where certain instructions may be installation dependent, space has been 
provided for you to write in the correct procedure for your installation after 
consultation with a representative from that installation. . 
» This volume takes the game operator from the worksheets filled out by 

placers of the game through the complete card deck which must be submitted for 
computer input. It discusses the various program options and utility support 
features of the M.E.T.R.O.-APEX system. 
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Chapter 2 



PREPARING TllK COMPUTER INPUT 



The first stop in the computer processing is the preparation of the 



input cards. There are eleven possible sets of input cards. Figure 1 shows 



the final arrangement of these sets of cards in the order in which they 

should be arranged for submission of a complete run to the computer. Some 

of these sets of cards may be only a single card, but they are^ shown separately 

because they must be included in exactly the location shown. Not all of the 

eleven sef" of cards will always be required for the program to operate 

correctly; the following discussion will indicate the circumstances in which 
ft 

they may be omitted. 

There are two main' sections of the M.E.T.R.O.-APEX cycle processing 
program. The first section processes the main player decisions and produces 
the bulk of the computer output: The second section prints the M.E.T.R.O.-APEX 
NEWS, the newspaper based on factors calculated in the first section and on 
actions taken by players on issues raised in the newspaper the preceding cycle. 
The second section also includes the Candidate Election Model, 

Since the main player decision cards (input set //5) constitute the bulk of 
the program input, are the most time-consuming to prepare and the most 
frequent sources of error, they should be prepared first. They may then 
be submitted for running (along with input sets 1 through 6) independently 
of the newspaper and issue input sets (7 through 11). The program will check 
the player decision cards for many types of inconsistencies and other incorrect 
coding and, unless you instruct otherwise, v/ill terminate processing if any 
errors are found. You may even instruct the program to stop after reading 
the main data cards even if no program detectable errors are found so that 




a may double-check the list of the cards printed by the computer. 



Figure 1. 
M.E.T .R.O.-APEX JOB INPUT DliCK 



(IJ.) 



(10) 




Special. headline cards (optional) 



(9) W Candidate Elect ion Model decision cards (optional) 

J- 



Wi-W Issue Decision card(s) — required except in^-cycie^O^on. J 



(6),- XX 



Newspaper Header Card 



■If 

(5) 1/ Main Player Decision Cards 



(.4) / . RUN (or- DATA) 



If 



(3) A- Additional Program Control Cards (optional) 



(2/ 



Main Header Card 



Job Control Cards 



A skilled operator can prepare the input sets for the newspaper and issue 
section of the program (sets 7< through 11) while the first section of the 
program is running on the computer and the newspaper can be printed in 
a separate job, bypassing the first main section of the program. Figur e 2 
shows the basic flow of the program and how these two sections of the program 
interact . 

The decision as to whether you wish to prepare and submit the complete 
program input deck (1-11) or submit the data in two sections will usually 
depend on the type of game run you are conducting. If you are playing only 
one cycle a day (or less frequently) you may prefer to prepare all of the 
input cards and assemble the complete data deck for submission. This is 
recommended particularly for the first few times you run the game, sinoeit 
involves fewer changes in the program option cards, less card shuffling and 
confusion and fewer chances of error in assembling the entire input deck. 

However, if you are trying to play two or more cycles in a day and 
attempting to minimize the time between cycles, the two step procedure will 
probably be required to reduce turnaround time between submission of your 
job to the computer and getting back the results. 

The rest of this chapter will discuss the input data card sets in detail 
in the order in which they are shown in Figure 1. 

Exa'bplfes of two-step data decks are included at the end of this chapter. 
Job Control Cards — input card set //I 

The M.E.T.RtO.-APEX computer program and data bank are stored outside the 
main computer on a type of auxiliary storage known as a magnetic disk. Your 
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computer iiisLallat ioii will probably liavc many of ihcsc disks available L»> Liu- 
computer. They arc capable of storing not only the M.K/l'.R.O.-AI'KX pro>;rams 
and data but. also many other programs and other data files. In order for any 
program to be executed by the computer it is necessary to transfer the program 
from its auxiliary storage into the main storage of the computer, tell the 
program where to find the data files it requires and finally instruct it 
to start operating. Depending on the model and si^.e of IBM 360 you are runnin 
on, the M. E.T.R.O.-APEX program may be sharing main memory of the computer 
with one or more other programs, all running simultaneously. All of this 
activity is controlled by. another program called the Operating System 
which resides permanently in the main memory of the computer and acts as 
"Big Brother" or traffic controller of the computer — fetching programs 
from auxiliary storage, getting data for them and directing their output 
back to disk storage or to a printer. 

This first set of cards in your input card deck is not part of the 
M. E.T.R.O.-APEX program but is the information required by the Operating 
System to control the loading and execution of the M.E.T. R.O.-APEX 
program (as well as information on how to charge you for the work done). 
It is written in a language ail its own called "Job Control Language". 

There are many elements of this Job Control Language which may be 
tailored to the requirements of a particular computer installation; 
therefore, as mentioned in the introduction to this manual, you sliould 
discuss this set of control cards with a systems analyst or other 
consultant at your particular installation before running M.E.T.R'.O,- 
APEX the first time. The examples given here will work in most installa- 
tions, but there are many options available, some of which will be dis- 
cussed in more detail in Appendix B. 
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Figure 3 shows the basic Job Control Cards for Inclusion ii^ sot 
//I of the input deck. Several items on these eanls have not been ex- 
plicitly specified and you will need to sub:--;.tute values specific to 
your installatioiu (If you expect to be running M.E.T.R.O.-APKX fre- 
quently at the same computer installation, discuss with your installa- 
tion representative the possibility of creating what is known as a 
"Catalogued Procedure" which would greatly reduce the number of Job 
Control Cards required. Details on suggested catalogued procedures 
are included in Appendix B.) The following is a card-by-card discussion 
of each card in the Job Control set: 

Line 1: The "JOB" card will most frequently vary from one installation 
to another. In some cases the installation will supply you with 
pre-printed, pre-punchcd JOB cards wliich will include accounting 
information and/or other installation dependent information. Usually 
you will be able to add additional options to the card supplied. 

If you are required to punch your own JOB card you must 
include the f o llowing : 

a) Substitute for "jobname" an actual name up tc 8 characters long 
beginning with an alphabetic character, such as MAINPROG, or 
MYJOB007. 

b) If accounting information is not required, you must punch a comma 
preceding your name to indicate the intentional omission of 
accounting information. It is recommended that you include in 
the name field, the name of the person submitting the job to 

the computer. 

c) Do not include any blanks or other special characters in the name 
field unless you begin and end the field with apostrophes; , ie. , 
LASTNAME, or, 'C. PRATT*, 
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d) The present 360/OS vc^rsion of M.E.T. R.O.-APIiX requires n 
region size of 120K bytes of main storage. This must he 
indicated on the JOB card as shown. 

e) The maximum time that the program is allowed to use the central 
processing unit of the computer is usually set by the computer 
installation at between 30 seconds and 1 niinute unless you specify 
otherwise on the JOB card. METRO-APEX will ^require more than 
this default time to process a complete cycle. Complete time 
estimates for all IBM 360 models is not available, however the 
time is approximately 8 minutes on a Model 50 and slightly less 
than 4 minutes on a Model 67. It is usually wise to specify a 
time limit slightly greater than you think will be required to 
make sure that your job is not abnormally terminated with only 

a little more time needed. We usually specify TIME=10 for a 
Model 50 and TIME=5 for a Model 67. NOTE: Since the priority 
a computing installation will assign to a job will decrease as 
time increases above the default time, if you are only running 
the player input decision cards through to check for errors, 
which will require relatively little time, you should omit 
the TIME parameter for data checking runs only. Don^t forget to 
include it on your JOB card after you have corrected errors and 
expect the program to run to completion. 

There may be additional parameters, such as job class, etc., which will 

be required by your installation. 
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Line 2 : (Optional) If your installation has allowed you to "catalogue'* 

the M.E.T.R.O.-APEX main program, under the name METAPEX, in the System 
Library this card will not be required. The System Library is, however, 
usually reserved only for very frequently used programs and, in most 
cases, the program will not have been installed in this way. Therefore , 
the //JOBLIB card will be required to tell the system where to look to 
find the METAPEX program. You will need to replace the XXXXXX following 
VOL=SER= with the identification serial number of the disk pack on 
which the partitioned data set APEXLIB is located. Note here for 
further reference: VOL=SER= 

Line 3 : Punch exactly as shown. 

Line 4: The data set reference number for card input data throughout the 

METAPEX Program is 2. (This is different Chan normal IBM 360 FORTRAN). 
This card informs the system of this fact. 

Line 5; The printed output data set number used throughout METAPEX is 3. 
(This is different than normal IBM 360 FORTRAN.) The maximum line 
length throughout METAPEX is 121 characters (120 printed plus 1 carriage 
control). Check this DD card with your installation representative for 
possible local modifications. Point out to them that a complete cycle 
with all roles playing will produce from 120 to 150 pages of computer 
output; this may require an output class other than A. 

Line 6: Required for system error messages. 

Line 7 ; This data set is used only for printing the newspaper. To save time 
in printing multiple copies of the newspaper, the first copy is written 
into this temporary sequential file which is then rewound and copied 
n times to SYSOUT. Your installation may wish to modify the specifi- 
cation. 
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Lines 8 - 11: Data sets 14, 17, 18 and 19 contain the initial data base 
for METAPEX, constants used from cycle to cycle, and issue pro- > 
cessing records. They are created by the FILEPRNT program (p:irt 
of the M.E.T^R.O.-APEX system in APEXLIB) and are normally inde- 
pendent of the number of games being played. Normally all of these 
data sets will be stored on the same disk pack. Replace XXXXXX 
on each of these lines with the correct volume serial number on 
which they are stored at your installation. 

Lines 12-13: Data sets 15 and 16 are the basic files containing variable 
data reflecting the changes in role accounts from cycle to cycle 
as game play progresses. At the beginning of the main section of the 
program both of these data sets contain exactly the same information. 
During the run of the main section of the program data set 15 is 
continually updated, so that at the end of the main section data set 
15 contains the '^current'* state of the game (the starting point for 
going on to the next cycle) while data set 16 contains the state of 
the game before the computer run; i.e. at the beginning of the cycle 
just played. 

From the above, it follows that if the next run of the program 
specifies going on to the next cycle, data set 15 is copied to data 
set 16 before the main program section. However^ if you choose to 
repeat a cycle, data set 16 is copied to data 15 before the firsjt^ain 
section. (More details of this cycle updating and/or repetition method 
is given in a later section of this manual. 

For most game operations the two control cards shown will be suf- 
ficient with the insertion of the correct. VOL=SER= number for your instal- 
lation. For those game operatores who might be running more than one game 
Q run at the same time or who wish to save a record of all cycles played, 

ER^C 

mmrntm the DSNarae parameter will need to be changed to be unique for each 
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team and/or each cycle. More details on this will be given later. 
Main Program Header Card — input card //2 

This card is the first card read by the M.K.T.R.O.-APEX program 
and is always required . It identifies to the program the team number 
(required) and tells the program whether you are (1) starting a new 
game, (2) going on to a new cycle of play, (3) repeating the entire 
preceding cycle or' (4) running only the issue and newspaper section 
of the program. You may also., on this card, specify a special team 
identification and/or special date to be printed on each page of the 
player output. >,^^ 

1. One, and only one*, of the following four keyv;ords must be punched 
on the main header card: 

CYCLE=n, *There is one exception to the rule that only one of 

_REPEAT=n, these keywords may be used. It will be explained 

NEWGAME later. 
NEWSP APER 

Explanation: CYCLE^ is used to indicate that you are going on to a 
new cycle. The new cycle number must be punched following 
CYCLE and it must be one greater than the preceding cycle. 
REPEAT=n indicates that you wish to repeat or restart a cycle. 
The value n which must be punched must be one greater than the 
cycle number stored in data set 16 (normal^ this is the same as 
the cycle you have just completed). 

NEWGAME indicates that you are restarting from the cycle 0 
history; i.e. you are about to run cycle 1 for a new game run. 
(Note: NEWGAME is included for convenience. Actually NEWGAME, 
CYCLE=1 or REPEAT=1 all produce exactly the same result.) 



NEWSPAPER is used if you wish to bypass the first main section 

of the program and skip directly to the issue and newspaper section. 

The team number must be punched on the main header card as follows: 

TEAM=n, 

Usually the team number will be 1 (except for special cases discussed 
in the section on Running More Than One Game). The program checks the 
team number stored on disk against this number to prevent errors. 
You may specify the date to be printed on each page of player output: 
DATE=mm/dd/yy 

The date specification is optional. If not specified the date used 
for the preceding cycle (or the last time DATE was specified) will be 
used. Note: you should always specify a date at the beginning of a ^ 
game (when NEWGAME is used). The program will check the date given 
and, if correct, will convert it to alphabetic month and day of week 
for printing in the newspaper masthead. 

You may specify a game run identification of up to 40 characters which 
will be printed on each page of the output in addition to the date. 
Usually this is specified only when starting a new game run; i,e, when 
running cycle 1. Unless specified the identification ' >^**M,E,T, R.O,- 
APEX INITIAL CYCLE DATA will be printed. Once a new team ident- 

ification is specified, it will_ remain in effect for all following 
cycles until changed. The method of input is as follows: ^ new team 
ident, ' Any combination of letters, numbers, special characters and 
spaces may be used, preceded and followed by apostrophes (') except 
apostrophes . You need not count exactly 40 characters. If you punch 
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fewer than 40 between apostrophes the program will fill the 
remaining spaces with blanks. However, if you punch more than 
AO any additional characters will be ignored. 

Rules f or punching the main header card ; All 80 columns of one 
card may be used. Punching may start in any column but may not 
be continued to a following card (you should never need more than 
80 columns). Keywords must be separated by blanks, commas or, where 
indicated, by = signs. The end of a numeric field must be indicated 
by a comma except for the DATE field where a slash (/) may be used 
to separate the month, day and year fields. The four possible fields 
on the main header card may appear in any order. All of the following 
e::amples are correct: 

TEAM 1, CYCLE 3, 'EXAMPLE OF TEAM IDENT' , DATE 2/1/72 

CYCLE 1, DATE 8/31/71, TEAM 1, 'THIS IS A NEW GAME $<:*L@// TIME 8:45' 

REPEAT 2, TEAM 1 

NEWSPAPER CYCLE 0, TEAM 1, DATE=10/27/71 , 'PRINT CYCLE 0 NEWSPAPER'"^ 
Note : The last card above is the one possible exception to the rule 
that only one of. the first four keywords may be used ^on a card. If 
used, the words NEWSPAPER and CYCLE must appear in that order and the 
number must be zero; CYCLE 0 NEWSPAPER is incorrect. 
Note in the above examples that either a^blank or = may separate 
keywords and numbers. Blanks must never be used within keywords , 
although only the first four characters of any keyword need be 
punched. 

*The cycle o newspaper is the newspaper' that precedes the first 
preset cycle 1 decision sequence. It is used primarily to ini- 
tiate linked issues in subsequent newspapers and may be printed 
O „ for distribution to the players to give them the background in- 
ERJC formation on issues appearing in the cycle 1 newspaper. 



16 

Caution; This option should be exercised prior to the starL of 
a new run only. Printing the cycle 0 newspaper destroys the 
record of the last cycle run for the designated team and resets 
the file for starting a new run * Normally, this option should 
not be used. 

Additional Program Control Cards ; — input^ card set #3 (optional) 

Additional program control cards are used to inform the M.E.T.R.O,- 
APEX program of non-playing roles, suppress printing of output, cause 
printing of some output not normally printed (usually for diagnostic 
purposes), and inform the program of some special newspaper options. 

The. additional program control cards consist of seven possible 
keywords followed by an equal sign followed by a string of options 
separated by commas* Each card must start with a keyword^ and must 
not contain any embedded blank coluians . The same ke3rword may be 
used on as many cards as necessary but the list of options may not 
continue from one card to another. Only one keyword may be used per 
card. Keyword cards may appear in any order. If contradictory options 
are included, the last one read remains in effect* 

keyword options 



NOPLAY= ALLDEVELOPERS 

ALLIN DUSTRIALISTS 

DEVELOPER (i) (i can be 1 through 7) 

INDUSTRIALIST (i) (i can be 1 through 7) 



Note: INDUSTRIALIST (4) and (7) are 
legal but unnecessary* 



SUPPRESS^ 




DEVELOPER (i) 
INDUSTRIALIST (i) 
POLITICIAN (i) 
PLANNER (i) 
APCO 



(i can be 1 through 7) 

(i can be 1 through 7) 

(i can be 1 through 5) 

(i can be 1 through 5) 

Note: IND(4) and (7) and POL and 

PLAN (2), (3) and (4) are- legal 

but unnecessary. The default 
is automatically SUPPRESS for 
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keyword 



options 



SUPPRESS= 



DISTRIBUTION 

SUMMARY 

DATA 

ALL 

NEWS 



PRINT= 



POLITICIAN (i) 
PLANNER(i) 
TOMMS TART 
TOMMEND 



(i can be 1 through 5) 
(i can be 1 through 5) 

Note: POL and PLAN (1) and (5) are 

legal but unnecessary. They arc 
printed by default unless sup- 
pressed. 



DIFFUS= 



ALL 

SPRING 
SUMMER 

FALL Synonymous 

AUTUMN/ 

WINTER 



ELECTION 



none 



BYPASS= 



CYCLEONE 
LINKS 
NATIONAL 
LOCAL 



CEM= 



DIAGNOSTICS 
RESULTS 



ERIC 



(Most of the above keywords and options may be abbreviated for ease in 
keypunching. The minimum num.ber of characters which must be used in each 
case is underlined.) 

The effect of each c'^ the above is as follows: 

NOPLAY: All seven developer roles and industrialists 1, 2, 3, 5 and 6 are 

considered playing by default unless the program is explicitly informed 
otherwise by use of a NOPLAY card(s). It is advisable to specify 
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non-playing roles since their omission will save a small amount of 
computer time. If not played in any cycle, the status of the files 
for a particular role remains exactly as it was the last cycle played, 
including taxes and loan payments owed and property holdings. If a role 
is not indicated as nonplaying and no loan or tax payment decisions are 
input for that role, the program will assume it was an intentional 
nonpayment and will assess delinquency payments and other penalties 
against that player's files which could create confusion if the player 
had merely missed a cycle and wished to resume play two cycles later. 

Notice the ALLDEV and ALLIND are available as a short-cut in the event 
you wish to suppress all of either or both types. 
SUPPRESS : Output for all of the developers and industrialists will auto- 
matically be printed if that role is playing unless you specify other- 
wise with a SUPPRESS card(s). (Notice that you need not specify both 
N0PLAY=D(1) and SUPPRESS=D(1)'; the NOPLAY automatically assumes no 
output.) 

Central City and County Politicians and Planners (POL(l) , POL (5), PL (1) , 
and PL (5) respectively) and the Air Pollution Control Officer's output 
will normally be printed unless suppressed. DISTRIBUTION refers to three 
tables in the output — a bar graph of land distribution and tables of 
developed and vacant property and prices. SUMMARY refers to several 
property and value tables, population and capital plant index summaries. 
Note that some tables usually given to the planners are categorized and 
printed among the SUMMARY tables; suppressing SUMMARY would suppress all 
of these. 
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Norma riy all of the main player decision cards (.mpiJt scl Ifb) an* 
printed as they are read. The SUPPRESS=I)ATA option will suppress Llus 
complete listing. All cards with any errors will still be printed along 
with a diagnostic message indicating the type of error. Since it is 
usually a good idea to check the input card listing for unusual decimal 
values, even though no program detectable error is indicated, this option 
should normally not be used except to suppress the printing of preset 
cycle 1 data cards or input lists of cycles being repeated. 

The SUPPRESS=ALL option will result in the suppression of all 
player output for the roles which preceded ALL in the list of options. 
It would normally be used only if you are repeating cycles with very 
minor changes for the purpose of file modification and no output was 
desired. Note that the ALL option does not suppress the newspaper section 
of the program . 

SUPPRESS=NEWS is the mechanism for running only the first main section 

of the program as suggested at the beginning of this chapter. If this 
optiou is used only input card sets 1 through 6 need be included in the 
computer input deck. Even if this option is used, the data required by 
the issue and newspaper processing section from the first part of the 
program is saved in the newspaper files and need not be recalculated. 

PRINT: Normally the output for simulated jurisdictions 2, 3 and 4 is not 
printed as it serves little use in the ^present version of the game. 
The printing indicated for planners 2, 3, A is only the recommended 
capital projects for simulated jurisdictions 2, 3 and 4» Since normally 



ERLC 
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no projects are recommended for these jurisdictions (county financed 
projects in those areas are shown as planners recommendations to the 
county) the output is not normally printed. 

TOMMSTART causes the printing of the initial distribution of population, 
employment and land use prior to the reallocation performed by the TOMM 
model. It is usually nothing more than a reiteration of summary data 
from the last cycle and not in a form which i*^ easily read by the players, 
hence is usually printed only for diagnostic purposes, which is rare. 
TOMMEND," like the start picture is for diagnostic purposes only and is 
not normally printed. 

DIFFUS : Any of these options print a detailed table of the levels of all 
pollutants in all of the analysis areas. The option was originally 
incorporated in the program for diagnostic purposes and the output 
is not easily read by the average player. ALL prints this information 
for all four seasons, but you may obtain it for any one or more of 
the seasons by so specifying. 

All of the preceding options apply to the first main section of the 
program. The following options apply only to issue, candidate election 
model and newspaper processing but, if used, they must be included in 
input card set //3. They may be included even if the newspaper is being 
suppressed; they will simply be ignored. 

ELECTION ; This keyword card, which has no additional options, must be in- 
cluded to inform the program to process a candidate election. Unless 
this card is included, input card set #9 (Candidate Election Model 
O decision cards) will not be read, even if included in the input deck. 

ERIC 
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CEM x DIAGNOSTICS will produce results unintelligible to anyone but the 
designer of the model. RESULTS prints a special analysis of ihv 
election result for each candidate; that is, for each eloc.tion, thi» 
percent attained by the incumbent will be brokoa into parts reflecting 
EOF performance, past performance in office, party support and the 
random factor (see Vol. 1, Chapter 4). It is usually used only for 
diagnostic purposes. These results are printed preceding the news- 
paper. The omission of CEM=RESULTS does not prevent the election 
results from being printed in the newspaper; the final results will 
be printed in the newspaper if an election is held. 

BYPASS ; Normally this option will not be used. 

Preset decisions for the three issues in the "cycle 0" newspaper are 
stored in disk "file" 237 and are normally used when printing the 
newspaper at the end of cycle 1. Notice that when running cycle 1 
the Issue Decision Card (input set //8) muse not be included in the 
deck ijnless BYPASSsCYCLEQNE is specified . If the game director wisb'^- 
to alter the contents of the first newspaper given to the players, he 
can specify BYPASS=CYCLEONE in which case an Issue Decision Card 
wi thN^the^^^^fH^^ for the cycle 0 issues I, 42 and 50 must be 
included in the cycle 1 data deck. 

The three issues in the "cycle 0" newspaper are ; 
#42 — (county) Runway expansion for airport, project 109. This is 
approved in the cycle 1 issue decisions. The main preset decisions 
for cycle 1 include a CP card for project 109 and BS card for bond 
number 111 to finance it. If this decision is changed the CP card 
and BS card should be removed from the cycle 1 data deck and new 
County Politician output (different than that in the player manuals) 




should be produced. 
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//I ~ (Ce ntrnl City) Build new City Hall, project 86. Tliis is 
also approved In the cycle 1 preset decisions iind a CP card for 
project 86 and BS card for bond //102 are included in the preset 
main cycle 1 decisions. As above, if this decision is altered 
the CP and BS card should oe removed and new City Politician out- 
put run. 

#50 — Annexation of Maple Grove Area, part of Analysis Area 12. 
This area is assumed annexed to the central city in cycle 1 and 
creates a demand in the cycle 1 newspaper for needed projects to 
service the area. 

BYPASS=LINKS will allow issue decisions entered for issues to be 
printed in the newspaper but any issues which would be generated 
by linking from a decision on one of the preceding cycle issues 
will not be printed. 

BYPASS=NATIONAL will suppress all preset state and national head- 
lines for that cycle. (A list of the preset state and national 
headlines may be obtained by running the FILEPRNT utility program 
and printing file 204.) These headlines are preset to give an 
indication of the national and state economy and social problems. 
You could simulate your own national and/or state headlines by 
inputting them as special headlines with a code of 1. 
BYPASS=LOCAL will suppress all preset county and local issues. It 
will not suppress issues linked to from preceding cycles, capital 
plant headlines, low per-capita budget generated issues or business 
page issues. 



As many Additional Program Option Cards as required may be included 



in t?ie input deck. The following are some examples of correct Program 

Option decks: 

ELECTION 

SUPPRESS=DEV(4) ,APCO 

NQP-I(2),I(5),D(5) 

PR=:P0L(4) 

RUN 

The following set is exactly equivalent to the above: 

SUP=D(4) 
SUP=APCO 

N0PLAY=DEVEL0PER(5) 

N0PLAY=IND(2) 

NOPLAY= INDUSTRIAL I ST ( 5 ) 

ELECTION 

P RINT=POLI TI C I AN ( 4 ) 
DATA 

In the following example of contradictory options Politician 5 would be 
printed since the last card read is the one in effect: 

SUPPRESS=P0L(5) 

PRINT=P0L(5) 

RUN 



The RUN (orDATA)Card - input card set ?/4 : 

The card is actually an additional keyword, but is shown as a separate 
input card set because it must be included in the input deck whether or 
not you have used any additional option cards . It indicates to the program 
the end of the Additional Option Card set and allows the program to continue 
on to the Player Decision Cards. You may use either RUN or DATA, not both. 



From Worksheets to Cards (Main Player Decision Cards, Input Set #5) 

Prior to the actual punching of the main input cards, the operating 
team must transfer and translate the decisions on the player's worksheets 
to coding forms. The player decisions are sometimes expressed verbally 
rather than in number code and appear, along with assorted extraneous 
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entries, on the worksheet. To facilitate keypunch operations, it is ad- 
visable for the operating team to translate the verbal decisions to 
numeric code and enter that code in the proper location on a key punch 
form. 

In certain instances, players may find the format of the worksheets 
time consuming, unproductive and restrictive. In those cases, the key- 
punch forms themselves can be used by the role advisors to direct the 
players through their decisions. In the extreme case, the players can 
go directly to filling in the keypunch form bypassing both worksheet and 
role advisor. 

Copies of the keypunch forms for each role are included in this 
chapter for reference. (Additional copies are available with the packet 
of worksheets and forms that can be purchased along with this manual.) The 
starred items on the worksheet have to be entered on the keypunch form. The 
coding for those items entered in verbal rather than numerical form is 
explained on the page following the respective coding forms. 

An example of the translation process will best demonstrate the 
procedure for filling in the coding form. (After a team of role advisors 
gains experience in filling in key>^punch forms, the expected time duration 
for the transfer and translation process is about five minutes per role.) 

Once the decisions are entered correctly on the key punch coding 
forms, the input cards must be punched. It is assumed that the reader 
is capable of using the key punch if not, a short introduction should 
be all that the reader needs. (The key punch is little more than a high 
powered typewriter, one designed for putting holes in IBM cards rather 
than for printing letters on paper.) 
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Data is entered on cards to conform with an arrangement in accordance 
with program specifications. Two distinct arrangements, called formats, 
are used. The first and most common allows up to thirteen entries on a 
card. The first takes up two columns, the next six take up four apiece 
for a total of twenty-four, and the last six take up nine each, filling 
the remaining fifty-four. Each grouping of columns is called a field. 
The first two columns are reserved for an alphabetic code of two letters. 
Each card must have an alphabetic code . The next six fields are reserved 
for integer entries. These must be right justified ; that is, the entries 
must appear as far to the right in each field as possible. For example, 
the number 12 would be entered in columns 5 and 6 on a card if it belonged 
in integer field 1. The remaining six fields are reserved for real number 
entries (numbers with decimal points). The entries may appear anywhere 
in the field but a decimal point must be punched in the appropriate loca - 
tion . 

A Word of Caution : Occasionally a field will require punching a minus 
(-) sign. When punched, the sign must be the first non-blank character 
in the field. (Many keypunch operators prefer to fill in the left-hand 
side of integer fields with zeros instead of blanks; e.g. BS00010025 
instead of BS 1 25. This has certain speed advantages when using a 
drum card, a discussion of which follows.) If you are punching leading 
zeros, the proper form for a negative number is, for example, -001 
not 00-1 . The latter form will result in the value zero being stored,, 
not -1. 

Each card corresponds to one line on the key punch coding form. The two 
letter code adjacent to each table is the two letter code in the first 
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field. The deslgnaLion Ir. .parentheses of "I-*" Indicates that the tMilry 
belongs in the *th real number field. (For FORTRAN buffs the input format 
is (A2, 614, 6F9.0) wi:h integers right justified.) 

The second format is used only twice, for PI and EM cards. The 
two letter code is handled exactly as it is above. However, the remainder 
of the card is psrtitioned into 15 four column integer fields; that is, 
all entries are integers^and all fields are four coltimns wide. Each entry 
goes in the f^eld indicated by the I-* designation on the key punch form 
and each is right justified . (For FORTRAN buffs the input format is (A2, 
1514) with integers right justified.) 

FOR THE IBM 360 VERSION OF M.E.T.R^O.-APEX THERE MUST BE T^Q PI AND TWO 
EM CART'S ADJACENT TO EACH OTHER IN THE INPUT DECK. They may be exact copies 
of each other or the first of the pair need have only the proper alphabetic 
coda in the first two columns. (The first occurance of the code tells the 
pvogram to read the data from the following card in the different format*) 

The key punch procedure is greatly simplified by the proper use of a 
drum card. A drum card is a high powered tab stop for a keypunch — it 
not only jumps to the right column; it sets the numeric or alphabetic 
(upper or lower) case as well. Thus, by using a drum card, letters are 
placed automatically in the first field and numbers are punched in all 
other fields. Note, use the numeric decimal point in all cases. Also, 
use caution when using the skip key (the analogue to the tab). When the 
machine is resting in the first column of a field, depressing the skip' key 
advances the field. (The key punch shifts to the next field.) 

A drum card for M.E.T.R.O.-APEX is made by placing a 1 in column one 
of an IBM card followed by an A. The first 'column of each remaining field is 
blank with ampersands filling the balance. (See Figure 4.) 
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Figure 4 
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For easy reference, the following is a chart of where each field bep;ins 
OTl^he card: 



Field 


Begins in 




Begins in 


Field 


column 


Field 


column 


I-l 


3 


F-1 


27 


1-2 


7 


F-2 


36 


1-3 


11 


F-3 


45 


1-4 


15 


F-4 


54 


1-5 


19 


F-5 


■ 63 


1-6 


23 


F-6 


72 



Note: The ampersand (&) is punched in what is frequently called the "12-row' 
of the card. 
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The XX card — Input card set #6 

Once all of the main player decision cards are complete, an additional 
card with the letters XX punched in the first two columns mu3t be added to 
the deck immediately following the last main player decision card. The 
XX card serves two purposes: (1) it signals the computer program that the 
last main player decision card has been read and (2) it informs the program 
what action to take after having read the player decisions. Normally 
the 1-1 field (columns 3-6) is left blank in which case the program will 
continue on with the normal processing sequence if there were no program 
detectable errors in the player decision cards but it will stop if the 
program did find errors in the player decisions. 

You may alter this normal action in one of two ways: 

(1) You may elect to have the program stop unconditionally after reading 
the player decision cards, in which case you must punch a negative 
number in the I-l field (usually -1 in cols, 5 and 6), 

(2) In very rare cases you may elect to have the program continue on even 
though it did detect errors in the player decision cards (for example, 
if you were starting a new game without playing all of the developers 
and/ or industrialists and did not want to remove all of the preset 
decision cards for the non-playing roles from the cycle 1 data deck) , 
Other errors will usually cause the card in error to be ignored and 
may result in unforeseen errors in the final output. Therefore, this 
option is to be used with great care. If you do elect to continue on 
despite errors, punch a positive number in the I-l field of the XX card. 
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Newspaper Header Card — input data set //7: 

The Newspaper Header Card is always required unless SW?RESS=NEWS 
is specified in the additional option cards (input set 3). It is required 
even for cycle 0 and cycle 1 newspapers since it informs the program of the 
number of copies of the newspaper to be printed and some other possible 
options. 

The following are the ppssible keyword options on the Newspaper Header 



There must not be any blanks within a keyword, but each keyword must be 
separated by either a comma or a blank. The comma following the number 
of copies is required unless it is the only or last option on the card. 
CQPY= or CQPIES= : Either form of this keyword may be used, followed by 
the number of copies of the newspaper you wish to have printed. If 
this kejrword is omitted the default is one copy. 
IGNORE : Once the entries on the Issue Decision Card are accepted as valid, 
the program verifies that the issue list is consistent with the linkage 
from the preceding cycle. (Each cycle, just prior to printing the 
first newspaper, the program prints a list of all issues that will link 
to other issues in the next cycle. This list is saved and the pro-^ 
gram checks that the issu^ decisions input for that next cycle include 
decisions for all those issues that required resolution to determine 
the nature of the linkage.) If some issue requiring resolution to 
direct the linkage to related issues is not included in the issue 
decision sequence, the following is printed! 



Card: 




[IGNORE] 



[ NOHEADS ] 



[ REREAD ] 



At least the first four letters of each keyword must be punched. 
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**MISSING DECISION FOR ISSUE nn (Other error messages arc listed 

in Chapter 3.) 

Normally, if missing issue decisions are found, the program will stop, 
the errors must be corrected and the newspaper section of the program 
restarted by specifying NEWSPAPER on the Main Header Card. 

The use of the option IGNORE on the Newspaper Header Card will cause 
the program to continue on despite the missing decisions. Any further 
linking for those issues will be ignored. 

NOHEADS: Since players almost always submit special headlines to be 

printed in the newspaper, the program assumes that Special Headline 
Cards (input set //lO) will be read unless NOHEADS is specified on the 
Newspaper Header Card. Notice that, although you would not normally 
do so, special headlines can be read for both the cycle 0 and cycle 1 
newspapers. Therefore IGNORE is usually specified on the Newspaper 
Header Card when printing a cycle 0 newspaper and frequently when 
running the cycle 1 preset decisions. 

REREAD : Once the program has printed one copy of the newspaper for any 
cycle it "remembers" what was printed. Any number of additional 
copies of the newspaper may then be printed without rerunning the 
main section of the program and without reading any of the news- 
paper and issue decision cards (input sets 8, 9 or 10) simply by 
specifying NEWSPAPER on the Main Header Card and the niimber of 
copies on the Newspaper Header Card. 
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Specifying the REREAD option on the Newspaper Header Card allows 

the operator to rerun the newspaper for a cycle with different alter- 

► . f ... 

natives for some of the Issues, different candidate data (if ELECTION 
is specified), different special headlines, or any of the other options 
possible (e*g., bypassing state and national headlines). In other 
words, REREAD forces the program to read input sets 8-10 • 

The ability to print additional exact copies of the newspaper, as 
mentioned above, may be useful if the operator wishes to check the printing 
of one copy before deciding whether to print many additional copies. For 
example, for some fiendish reason known only to the game director, he may 
want to be sure that some candidate wins or loses in the election. If, 
the first time through, the election result is not as desired, the operator 
can further bias the election results by changing the party support higher* 
or lower and REREADing the decision cards. If the result was as desired, 
sufficient exact copies may be printed *to pass out to players. 

Notifce that if one copy of the newspaper was not printed, due to a 

fatal error in one or more of the input card sets 8, 9 or 10, the program 

will assume that these cards are to be reread. 

Issue Decision Card(s) — input card set //8 : 

An issue decision card contains one or more groups of numbers 
separated by commas. Each group of numbers gives the program in- 
formation about one issue appearing in the newspaper that was printed 
at the end of the preceding cycle. The information is comprised of 
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two required entries; the issue number and the alternative* acted upon 
by the deciding agent (a politician or the elite opinion poll). Lf Ihv 
alternative action required that a project be funded, the bond or millage 
number associated with that project may be given. 

The format for issue decisions is as follows: iiia(bbb) , iiia, iiia 
(bbb), . . . iiia* 

Where: iii is a 1 to 3 digit issue number 

a is a single digit indicating the alternative chosen on that issue, 
(bbb) is an optional 3 digit bond/mill number 

The card is " free- format" ; that is, punching may begin in any column, 

and blank columns are ignored and may be used for spacing to increase 

legibility. Each group of numbers for a single issue is separated by a 

comma* However, the last group must be terminated by an asterisk (^) ^ 

not a comma. A maximum of AO issue decisions may be input in any single 

cycle. If one card is not sufficient for all issue decisions, decisions 

may be punched on any number of additional cards. The terminating 

asterisk appears only after the last decision on the last card of the 

series. The last character on any one card must be either a comma or 

an asterisk. Thus, a number group for any one issue must appear on 

only one card — it will not be continued from one card to the next. 

The following is an example of two issue decision cards: 



1692, 1 1, 



^ 56 1 (103), 28 3 * 
This would be interpreted as follows: 

Alternative 2 for issue 169, alternative 1 for issue 1, alternative 1 for 
Q issue 56 subject to the passage of bond 103 (otherwise, if bond 103 failed, 

FRIC 

ma^ta the alternative would be changed to 2 by the program), and alternative 3 
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for issue 28. Note that ail of the above could have bt*en punclKHi on 
one card; the two cards were used only for illustration. A key punch 
for issue decisions (see next page) is included in the packet of forms 
for use by the operator. 

In each cycle, the alternative selected for every issue appearing 
in the preceding cycle's newspaper must be entered as part of the issue 
decision cardset. Use of the elite opinion poll wall chart tally sheet des- 
cribed in Volume I, Chapter 3 of this kit is extremely useful in keeping tabs 
on issues and issue outcomes. 

Candidate Election Model decision cards — input card set y/9: 

This input card set must be included, and may only be included, if 
you specified ELECTION in the Additional Program Control Card set. 

There are up to 16 candidate election data cards in an election year. 
A card ir.u&t be punched for each incumbent politician running for office. 
(Up to eight incumbents — three central city politicians, one county 
commissioner representing each outlying jurisdiction and two count^^ com- 
missioners representing the city — can run each cycle.) For each in- 
cumbent running for office, a card must be punched for either his sim- 
ulated or game opponent. 

The following format is used for punching candidate election data 
cards . 

Cols. 1-2 Candidate Number. A candidate number must be entered 

on each card. Incumbents should be assigned numbers 
1-8 according to the following schedule: 

1= Central city politician, ward 1. 
4= Suburban county commissioner 

5= Township I (jurisdiction 3) count}^ commissioner 

6= "2 " 4 " " 

7= Central city "at-large" representative on county board. 
g_ tt 11 fi ri fi ir n 
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Corresponding numbers from 9-16 should bo assigned to their oppojUMits 
so that each matched pair are given numbers 8 apart; that is, opponeut 12 
runs against incumbent 4, etc. Do not punch cards for opponents if there 
is not a card for the corresponding incumbent. 



Col*- 3 a) For incumbents (01-08 in columns 1-2) "this column 

indicates whether the opponent is real or simulated: 

1 = gamed opponent (real) 

2 = simulated opponent 

b) For gamed challengers (09-16 in columns 1-2) this column 
should be blank. For simulated challengers this column 
designates the opponent type: 

1 = Conservative 

2 = Moderate Republican 

3 = Labor Liberal 

4 = New Left Liberal 

5 = Working Class Conservative 

6 = Ultra-Conservative 

7 = Business Candidate 

8 = Black Candidate 

9 = Reform Candidate 

Cols. 4-8 Party support. This entry is included only for incumbents. 

It is the major discretionary variable under the control of 
the operator. Some number between 1 and 60 is entered 
designating the percentage of the vote, up to 60%, going 
automatically to the incumbent. The entry can be deter- 
mined by apportioning the 60% in accordance to a hand 
vote of gamed players, operator's whim or any other 
suitable method. If the entry is left blank, the machine 
sets the appropriate variable to 30. A decimal point must 
be punched in this field . 

Cols. 9-28 Candidate Name. A name up to twenty characters long is 

entered here to be printed with the election results in 
the newspaper. Names should be entered for simulated as 
well as gamed opponents. For example, a conservative might 
be called Richmond L. Stuffshirt. 

Issue Number, Candidate St ^d on Issue, and Candidate Stress 
on Issue. The fom folio that for issue decision cards — 
iiia(bb) — where iii is a 1 to 3 digit issue number, a is 
the alternative chosen and bb is the percent >of campaign 
funds spent stressing the stand taken on that issue. These 
entries are free format and ;Up to 40 issue decisions may 
be entered. Additional cards may be used as needed with 
the continuation card starting in column 1. 



29-80 
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An asterisk is used to desij»nate the. end ol tin* 
sequence for a given, candidate?. Kntries should 
be made for only those issues for which the can- 
didate casts a vote. Note that these columns 
should be left blank for simulated opponents. 
Also, for unstressed issues (Issues which would 
have zero in parentheses) the parentheses may be 
omitted. Stress percentages must be entered as 
whole numbers; decimal points may not be included 
within the parentheses. 



One blank card must follow the last candidate card to terminate 
this section of the input. The following is an exam* le of a card for an 
incumbent candidate : 

1^01125. OOROY MILLER 1691(20) ,0012(5) ,0563,0423* 

Incumbent 1 has a real o],, nent named Roy Miller. Twenty-five percent of 
the party allocation .s been assigned to him. He has voted for alternative 
1 on issue 169 and spent 20 percent of his campaign funds stressing that 
stand, etc. 

Special Headline Cards — input card set //lO: 

Special headline cards are assumed part of the newspaper input 
sequence unless JOHEADS is specified on the Newspaper Header Card. 

This input section contains special headlines written by the 
operator, a newspaperman or players in the game for publication in 
the News. These cards, like the others, must be punched to confoann 
to program specifications. Each line of a headline appears on two 
cards. The first column of the first card of each pair must have a 
code describing the type of headline. The possible codes are: 

1 = Special Headline (lead article) 

2 = National Headline 

3 = State Headline 

4 = County Headline 

5 » Central City Headline 

6 = Suburb Headline 
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7 = Township 1 Headline 

8 = Township 2 Headline 

9 = Business Headline 

The rest of the first card, columns 2-80 contain the first 79 characters 
of the line. The first 41 columns of the second card contain the last 41 
characters of the same newspaper line. There can be a maximum of 118 lines 
in a given cycle. 

The cards must be ordered so that the codes in column 1 are in 
ascending order from 1-9. To skip a line between headlines in a single 
section (with the same code in column 1), one of the 118 lines must be 
left blank; that is, the appropriate code should be entered in column 1 
of a card but the remainder of the card and a second card should be left 
blank. The program automatically handles the placement of each section; 
therefore, blank cards are not needed between sections (between headline 
cards with different codes in column 1). 

Delimiter Card — input card set //II ; 

This card, which contains nothing but /* in card cols. 1 and 2 
should always be included as the last card in the input deck. It serves 
two purposes; (1) it signifies the end of special headline cards, if 
present, and (2) signifies the end of the total input deck. , 

SUMMARY 

In summary, the data deck required to run a cycle fr6m start to 
finish is pictured in Figure i. It is not necessary, as noted at the 
beginning of this chapter, to run the entire program at one time. There- 
fore all of the input card sets shown in Figure 1 need not be included 
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in every deck submitted to the computer. The foilowuig examples show 
subsets of the complete data deck which may be used for certain purposes, 

> 

Figure 5 

INPUT DECK FOR ONLY M^IN SECTION OF PROGRAM 



XX 



Main Player Decision Cards 



DATA 



Additional Program Control Cards (optional) 



SUPPRESS=NEWS 



Main Header Card — including TEAM and either NEWGAME,- CYCLE=n or REPEAT^n 



Job Control Cards 
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Figurn 6 

INPUT DECK FOR PRINTING NEWSPAPER 
( If Newspaper Suppressed Previously ) 

7^ 



//special Headlines (Unless NOHEADS on Newspaper Header Card) 

/ 

■/^ Candidate Election Decision Cards {if ELECTION card was used) 
;■/ Issue Decision Card(s) 

'/ Newspaper Header Card 

f ■ - 

/ RUN 

'ELECTION (optional) 
C NEI7SPAPKR, TEA14=i 

/ _ 

/; Job Control Cards 



Figure 7 



INPUT DECK FOR PRINTING ADDITIONAL EXACT COPIES OF NEWSPAPER 
(Assume dt least one copy has already been printed) 



/z. 

[ / COPIES=n 



■^RUM 



; NEWSPAPER, TEAM=i 
^/ Job Control Cards 
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Chapter 3 
ADDITIONAL GAME DIRECTOR INPUTS 
In addition to the operational controls and player decision discussed 
in the preceding chapter, there are a number of additional opt'Lons available 
to the game director or operator for changing the values usrd in some of the 
game models and otherwise manipulating the outcome of the game for a par- 
ticular cycle. The mechanism for introducing these op'-ions into the game 
is by means of cards which are prepared in the same format as and are 
included in the input deck with the main player decision cards (input card 
set //5 )« Since they are not usually player decisions, space for recording 
the values is not usually included in the player worksheets and standard 
keypunch coding forms. Instead they are recorded as part of the ^^Instructions 
-to-Computer Operator" form. (Notice t!iat two of these inputs are additional 
fields punched on the Player Decision Cards, although not on the player 
worksheets.) 

Change U.S. Exogenous Employment Growth Rate : 

This value is the percent change in exogenous employment, both 
industrial and office (bureaucratic), except for the gamed industries, 
state government employees and the university employment in a cycle. 
It is preset at the actual values for the years 1957 through 1966 unless 
changed by the f;ame director. A change in this value will have an effect 
on the growth of the entire gamed area. The precise change is not 
completely predictable, since growth is also affected by new industries 
entering the area (see Forcing Exofirms below), additional exogenous 
employment in specific analysis areas (see Additional Exogenous Employment 
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below) plus a small random factor. Changes in this value will also, 
obviously, have an effect on the M,E,T,R*,0,"APEX area unemployment 
rate — the average unemployment changing in inverse ratio to the 
employment growth. 

The Employment Growth Rate may be changed by including in the 
Player Decision deck a card with EG punched in columns *.l and 2 and 
the nav percentage value in columns 27-35 (be sure to punch a decimal 
point) . 

Unless changed by use of the EG card the following are the preset 
U.S. Employment Growth Rates used by the program for each cycle: 

Cycle Percent 



1 


-0.9 


2 


0.5 


3 


2.5 


4 


1.7 


5 


0.2 


6 


1.6 


7 


1.4 


8 


2.3 


9 


2.6 


10 


0.8 



Forcing Exogenous Industries (Exofirms) into Specific Areas : 

Each cycle the newspaper lists a small group (from 3 to 6) 

0 

of exogenous industries that wish to locate in the METRO-APEX area. Each 
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of these industries has a preferred location or locations (listed in 
order of preference) plus one or more conditions which must be satis- 
fied by the politicians and/or developers in order for them to locate 
in the community. These conditions may be construction of streets or 
sewers, rezoning of land for industrial use or investment of money by 
the developers. 

The players are sometimes confused as to the specific actions 
they must take. As far as street and/or sewer construction is con-- 
cerned, the program does not look for specific projects — it simply 
checks to see whether the total dollar amount of all projects of the 
correct category (streets or sewers) being allocated to the desired 
analysis area is equal to or greater than the amount required by the 
exofirm (notice that they must be AA-wide projects; the program does 
not check for money spent in the ward or jurisdiction). The total 
amount of all developers^ and industrialists' investments in that 
exofirm must be equal to or greater than the amount specified in the 
newspaper. Note that more than one developer and/ or industrialist 
may invest in the same exofirm and that the amount invested may be 
more than required. The rezoning requitement will be met if the total 
number of acres rezoned to vacant industrial (vacant type 4) is equal 
to or greater than the number of acres required. The old land use 
type is immaterial and the total may be made up of several small parcels 
or one large one. The program considers all such parcels as contiguous * 
The game developers should be advised that the exofirms which do enter 
will not purchase vacant industrial land from them but only from the 
general market . 
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They should also be advised that they cannot rezonc. land to vacant 
industrial and sell that land to the market in the same cyelo . 

Sometime the players will form a scheme to create an industrial 
park in some location and request that the exofirms locate in that area. 
Other times the game director will wish to force in an e: Dfirm despite 
the fact that all player requirements have not been met, or he may 
wish to locate the exofirm in some area other than those listed in the 
newspaper. The "Exofirm Force" card is the mechanism for accomplishing 
either of these goals. The format is: 

Cols. 1-2 XF 

Cols. 3-6 Exofirm number, right justified. 

Cols. 7-10 Analysis area into which the firm is to be forced. 

If zero or blank the firm's first choice will be used. 

Notice that there must be one card for each exofirm to be forc^id. 

Additional Exogenous Employment : 

Another method the operator or game director cJxi use for changing the 
distribution or magnitude of employment in a specific area is by means of 
the EE (Exogenous Employment) card. By this means he can create larger 
growth than available with most preset exofirms. Th. format is as follows:^^ 

Cols. 1-2 EE 

Cols. 3-6 Analysis area in which to locate 

Cols. 7-10 Type of employment: 1 = Industrial (manufacturing) 

2 = Office (bureaucratic) 
Cols. 27*35 (F-1) Number of employees (include decimal point) 
Cols. 36-^4 (F-2) Number of acres required (include decimal point) 
Cols. 45*53 (F-3) Dollars of added tax base (include decimal point) 

Entering Background Pollution Levels for Each Season : 

The game director may wish to create an air pollution crisis by adding a 
fixed quantity of each contaminant throughout the region in one or more 
seasons. The mechanism is by means of the BP card, the format for which follows 
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Cols. 1-2 BP 

Cols. 3-6 Season code number; 1 = winter 

2 = spring 

3 = summer 

4 = fall 

Cols. 27-35 (F-1) Particulates (micrograms/cubic meter) 

Cols. 36-44 (F-2) SO2 (parts/million) 

Cols. 45-53 (F-3) CO 

Cols. 54-62 (F-4) NO " . " 

Cols. 63-71 (F-5) Hydrocarbons 
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No attempt will be made here to suggest realistic values. They may be 
obtained from the various APCO reference materials. 

Over-ride Automatic Calculation of Industrialists' Dividents : 

Normally the program will automatically calculate dividends to be 
deducted from each industrialist's cash balance. The amoiont deducted 
is usually all of the cash increase over 00,00. If the game director 
chooses to override the automatic calculation of dividends (for example, 
if he has some prior agreement with the industrialist or knows that the 
industrialist has applied for a loan to increase cash on hand for the 
purpose of expansion but has not yet spent it) he may do so by means of 
the DV card. 

Cols. 1-2 ' DV 

Cols. 3-6 Industrialist number (either 1-6 or 8-13 is acceptable) 

Cols. 27-35 (F-l) Dollar amount of dividends to be deducted. 

Change Industrialist Average Annual Wage ; 

The game director may stage some labor strife for one or more of 

the industrialists which results in a change in average wage scale for 

his employees. If so, the new wage scale should be punched in the F-4 

field (cols. 54-62) of the PL card for that industrialist. Note; this 

fiplH jcj nr>t; included on the -Industrialists worksheets or coding forms 

since it is not a normal player option. However, if some industrialist 

feels particularly altruistic he may request a greater increase than 

^[^(^ normally produced automatically by the program. 
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Change State Equalization Factor for Property Tax Calculation : 

This is a very rarely used option but one which may be employed by 
the game director if he wishes to announce that the State Board of Prop- 
er tyEqualization has discovered that a particular jurisdiction is not 
assessing property at the legally required 50% rate. The equalization 
factor adjusts the actual assessment percentage to 50% before applying 
property tax millage. Note: only jurisdictions 1 through 4 can be 
changed. County millage is applied against the taxable property value 
of each jurisdiction. The method of entering this value is: 



Cash Transfers To or From Operator To or From Any Player : 

This is a very convenient mechanism for either adding cash to or 
removing cash from any player's account without effecting t^ account 
of any other player. It can be used for correcting uninten. ional 
depletions of a player's funds as, for example, restoring an over 
deduction of dividends for an industrialist. It could also be used 
to give federal or state subsidies to developers for low-income 
housing development or used to fine developers or industrialists 
for zoning infractions. The method is the use of ^ Cash Transfer 
(CT) card, the same as that used for cash transfers between game 
players, except that a code of 99 is used in either the "to" or 
"from" field to indicate that the destination or source is "operator". 



Cols. 1-2 
Cols. 3-6 
Cols. 27-35 



AC 



Jurisdiction (only 1 through 4 may be changed) 
Assessment factor. This must be entered as a 
proportion, i.e. a fraction less than 1.0. 
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Special Grants to Politicians : 

This option is similar to the Cash Transfer except that it is a 
method of adding cash only to one of the five political jurisdictions 
(usually only Central City or County) and the Special Grant can be ear- 
marked for either tie General Operating Fund or the Capital Improvement 
Fund. It is shown on the Player Output for the Politicians as a specific 
line item in both the General Fund and Capital Fund budget pages. 

As many individual special grant cards as desired may be input 
to the program but it is something of a waste of effort since the 
program simply totals all special grants in the same category and 
prints only the total on the output. The method of input is: 
Cols. 1-2 SG 

Cols. 3-6 Jurisdiction to which grant is made; 1 = Central City 

5 = County 

Cols. 7-10 Fund to which grant is made; 1 = General Fund 

2 = Capital Improve- 
ment Fund 

Cols. 27-35 Dollar amount of grants to that fund. 

Federal Grants for Air Pollution Control Program : 

This is an important part, usually the major part, of the Air 
Pollution Control Office budget. These funds are allocated by the 
Game Director or someone he has designated as the federal represen- 
tative in response to applications by the Air Pollution Control 
Officer. They may be either new grants or supplementary grants 
and may be for one, two, or three years. These funds are input on 
a special form of the APCO's Budget Request (BR) card, usually 
referred to as the BR-3 card. 
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Cols. 1-2 BR 
Cols. 3-6 0003 

Cols. 27-35 Total dollar amount granted for current cycle . 

This is the total, not for any one of the six 
lines in the APCO budget. If the J^FCO already 
has Federal Funds allocated for this cycle from 
a previous cycle, this becomes c supplementary 
allocation and is added to the amount already 
in the APCO file. 

Cols. 36-44 Federal funds (dollars) for next cycle. The above 

comments apply. 

Cols. 45-53 Federal Funds (dollars) for cycle after next. 



Reducing Federal Air Pollution Control Allocation 

The Game Director (or federal representative) has one other option 
for controlling the APCO's funds. Each cycle the APCO output lists federal 
funds granted for each of the following two cycles (a result of a two or 
three year grant on a BR-3 card above) and the APCO may make his budget for 
the next cycle'on the basis of the federal funds he assumes he will be re- 
ceiving. However, the game assumes that the government can change its mind. 
The Game Director may decide that he will introduce a "federal money squeeze" 
and has the option of specifying that some percentage less than 100% of the 
federal funds listed in the APCO output will actually be available. The 
operator does this by coding in the 1-2 field (cols. 7-10) of the BR-_2 
card (the card on which the APCO allocates his federal funds to his six 
budget items) an integer percentage less than 100 which is the percentage 
of federal funds which will actually be available. Note: this' value must 
be greater than zero . (A zero or blank field defaults to 100.) The program 
multiplier each of the six federal budget items by this amount and, if 
necessary, cuts the corresponding County budget items back to 1/3 of the 
federal budget. 
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Chapter 4 
Error Messages 

During the computer procx?ssing component of M.E.T.R.O. -APEX, many oppor- 
tunities exist for error. Frankly, it is a rare occasion when the processing 
of a set of decisions is free from error. The need for quick and accurate 
corrective action is most dramatically demonstrated during runs requiring 
rapid turn around because processing errors disrupt player strategies (ommLs- 
sion of a single card might result in the non-execution of a crucial activity 
in connection with some major plan) and upset the morale of the audience and 
the timing of the game. 

Errors arise from. many sources. Players make errors in specifying the 
exact nature of their decisions. Coders of key punch forms make errors in 
transposition. Errors can be made by key punchers and, finally, the operator 
can communicate incorrectly with the program. The most difficult errors to 
correct are player mistakes— unless the role advisor is sufficiently close to 
the players to place the logic of player decisions correctly on the worksheets, 
the computer operator can not correct these mistakes. (The MISMATCH OF SCALE 
error is the most common error of this type.) Other errors can and should be 
corrected; unfortunately however, the addition of a zero on a number, the 
minor miscoding of a single number, etc., often go by undetected. One useful 
activity that often minimizes the occurence of such errors is to unconditionally 
halt after re^qding the Main Player Decision cards and visually check the listing 
for errors prior to advancing the program beyond that section. A second activ- 
ity, if time is available, is the reading of the output for glaring inconsist- 
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encics and t'rror.s ami Lhci roruniiln>» oi' Lho cycle Lo correct Llic* in i t a.u's . As 
the. operator ^aliis experience the K-^nie, his speiMl nnJ ahllllv l<> i.Mch 

errors hefori' output is reLurned Lo the players shonhl y^o up markedlv. 

This appendix takes up all the diagnostic error messages that may Ur 
printed during the normal run of M.E.T.R.O.-APEX. Each type of error is con- 
sidered in a separate section of this appendix. 

VERY IMPORTANT WARNING! Methods of restarting after error termination . 
First, some background information: 

After reading the Main Header Card, the M.E.T.R.O.-APEX program makes a 
decision about which files it needs to continue processing. After a normal 
termination of a cycle of the game, data set 15 contains a record of the final 
state of the variable player accounts for the cycle just concluded and data 
set 16 contains the status of the same accounts at the beginning of that cycle. 
In particular, at the end of the computer run for cycle 2, for example, the 
cycle number stored in data set 15 is 2 and the cycle number in data set 16 is 1. 

The decision the program makes at the beginning of a run is as follows: 
a. If CYCLE=n (n greater than 1) is specified on the Main Header Card , imply- 
ing that you are going on to a new cycle, data set 15 is copied into data set 
"16 so that at the beginning of decision processing both data sets contain ex- 
actly the same information. When this copy operation has been successfully 
concluded the program prints the following message: 

STATUS AT END OF CYCLE n HAS BEEN COPIED FROM DATASET 15 TO DATASET 16 
FOR START OF NEW CYCLE 

Once this message has been printed you must use REPEAT- on the Main Header Card 

to restart the cycle due to any errors which may occur after it (as well as to 

simply rerun the cycle with different decisions). If fatal errors have occurred 

prior to printing this message (errors in JCL or on the Main Header Card itself) 

you should simply correct the error(s) and restart retaining the CYCLE= on the 
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Main M^iatlur Card. 

b. If you had specified WCI'KAT=n (ii greater than 1) on Lh(! Main lltMder Caril, 
the program copies data set If) into data set 15. Wht»n this copy operation has 
been successfully completed the program prints tliis message;: 

DATAbU:! 16 HAS BEJ£N COPIliD TO DATASET 15 FOR REPEAT OF CYCLE n 
Since the records in data set 16 are not changed during processing you can 
restart using REPEAT=n for any errors which may occur. 

c. CYCLE=1, REPEAr=l and NEWGAME are synonymoys. They each result In data 
set 14 (the base team data, with cycle number 0) being copied into both data 
set 15 and data set 16. (This is the only time data set 14 is used.) Since 
this is the case, «'my errors in running cycle 1 can be corrected and restarts J 
using any of the above options. 

Notice that the above restart procedures apply only to errors which may 
occur in input card sets 1 through 6. Assuming the first Main Section of the 
program runs correctly, any errors in input card sets 7 tlirough 10 (issue 
and newspaper data) should be corrected and restarted using the NEl^SPAPER option 
on the Main Header Card and removing input card sets 3-6 from the input deck. 
(See Chapter 3.) 

A. Errors in Job Control Cards ; 

Errors which may occur in the Job Control Language at the beginning of 
your input deck could be many and varied and will not be dealt with at lengtli in 
this volume. Any that do occur w!ll probably be due to discrepancies between 
the requirements of your installation and the sample set of JCL shown in Chapter 
3, Figure 3. Among the most probable sources of error are: 

Punching the incorrect VOL=SER=code on tlie DD cards, particularly 
FT15F001 and FT16F001 if running multiple teams or saving all cycles. 
Incorrect UNIT or DCB parameters on cards FT03F001 and FT09F001. 
You should consult with a representative of your computer installation for 
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diagnosis of .ICL terrors. 

Errors on the Main Hoador Card ; 
As each program control card is read by the computer it is printed on Lho 
output for record purposes whether or not it contains any error. The program 
section which scans and interprets the Main Header Card will print a $ sign 
under the line on which the Main Header Card is printed in the position where 
an error is detected. The type of error will be indicated on the follov/ing line. 
All possible errors will be checked on the Main Header Card and up to 10 errors 
in Additional Program Control Cards will be detected before the program will 
terminate. 

*** ILLEGAL OR CONTRADICTORY KEYWORD ON HEADER ~ ' ' 

Only the first four characters of the Main Header Card keywords are 
checked. The above message will be printed if the program does not find one 
of the following: NEWG, CYCL, REPE, NEWS, TEAM, DATE. The four characters 
which are considered illegal are printed following the message. One possible 
source of illegal keywords could be the use of apostrophes (') within the team 
identification field. This string of characters starts with an apostrophe and 
is considered ended when the next apostrophe is detected. Therefore any addi- 
tional characters following the second apostrophe is considered another keyword. 

A keyword is considered contradictory if it appears more than once on the 
Main Header Card or, with one exception, if more than one of the keywords NEW- 
GAME, CYCLE, REPEAT or NEWSPAPER is used. The one exception is that the key- 
word CYCLE may follow the keyword NEWSPAPER. 

ILLEGAL NUMBER ~ ' ' 

The following. are considered illegal numeric values: 

1. Any value less than 1 or greater than 10 following CYCLE or REPEAT, except 

2. Any value other than 0 following the combination NEWSPAPER CYCLE. 

3. Any value less than 1 or greater than 5 following TEAM. 
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^4. , Any iK»>»;iliv(' or y.vra v;ilu«' Ln any ol" ilu- tliriu^ DATK Mi'lihi. (Ihi i or i un.iU- i v 
wi' will rllln'r liavr lo iiintii ly I Iir proj'r.iin or iio( i>lMy MJC, *(*. -AriiX in 
LIk! year ^OflO, ) 

*** Dlf) NOT FIND 'CYCLE\ 'f^EPi-AT', OK ' NKWfJAMi:' ON IlKAi)I':R CARD 

This message is printed if one of tlie keywords NEWCi, CYCL, REPE or NEVJS 
is not on the Main Header Card, 
*** TEAM NUMBER NOT GIVEN ON HEADER CARD 

Self-explanatory, The team number is required, 
DATE NOT GIVEN, WILL USE DATE FROM PRECEDING CYCLE mm/dd/yy 

The above is not a fatal error, but only a warning. If the date is not 
specified, the date saved in bytes 3-8 of "file 16" will be used. If starting 
a newgame this date will be all zeros and will be found incorrect at a later 
point, therefore DATE should always be specified when starting a now g;amo. 
*** ILLEGAL CHARACTER IN EXPECTED NUMERIC FIELD 

Only the ten numeric characters, 0 through 9, blanks (which are ignored), 
or the terminating character comma (or / for date fields) are legal following 
CYCLE, REPEAT, TEAM or DATE. Any other character will give the above mes- 
sage. The most usual causes are (1) failing to terminate the number with a 

comma or (2) failing to separate the number from the preceding keyword with a 
f 

blank or equal sign* For example, both of the following would produce the 
above error message: 

CYCLES, TEAM 1 
CYCLE 3 TEAl^ 1 
$ 

SLASH ILLEGAL HERE 
Slashs are only legal separators between parts of the DATE field. Any 
other occurrance following a number will produce the above error* 
*** mm/dd/yy IS AN IMPOSSIBLE DATE 
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The program contains an algorithm which checks each field of Uic dale tor 
correctness. The month must be 1 through 12, the day must be greater than zc.vo 
and less than or equal to the correct number of days in the corresponding month 
(a check for leap-years is included), and the year must not be equal to zero 
(as noted above). 
**** TEAM NUl^ER/FILE MIXUP 



151 



16 



FOOl IS n 



TEAM NUl^ER IN DATASET SPECIFIED ON Fit 
TEAM NUMBER ON HEADER CARD IS m 

The team number (from 1 to 5) is stored in the bytes 75-76 of record 71 
of data sets 15 and 16 by utility program NEWTEAM (see section on Utility Pro- 
grams for M.E.T.R.O.-APEX) which must be run prior to the first time a game is 
run for any team. Each time NEWGAME, CYCLE 1 or REPEAT n is specified the team 
number in both files is compared with the team number on the Main Header Card. 
When any CYCLE other than 1 is specified the team number in data set 15 is 
compared with the team number on the Main Header card. The above message is 
printed if the numbers are not the same to prevent inadvertant destruction of 
the wrong team files. 

The error is caused by either (1) not having preset files for a now team 

the NEWTEAM utility or (2) either the wrong data set DSNAMIZ specified on 
the appropriate DD card or the wrong team number on the Main Header Card. 
CYCLE NUMBER IN DATASET 16 WAS n. SHOULD HAVE BEEN m. 

CHECK NUMBER OF REPEAT CYCLE OR DSNAiME ON FT16F001 CARD. 

This message will only occur in conjunction with REPEAT on the Main Header 
Card. The cycle number in bytes 1 and 2 of record 71 of data set 16 must be one 
less than the cycle being repeated; in other words, the record at the end of 
the cycle preceding the one being repeated. If you are using the Basic Job Con- 
trol in Chapter 3, this error could be caused by trying to repeat a cycle earlier 
than the last cycle completed. If running multiple teams or saving the records 



of all cycles it could bo caused by the wrong DSNAMl'. on Fi'jOl'OOl !)!) 
CYCLK NUMJiER IN DATASliT 15 WAS n. SHOULD llAVK BHHN m. 

CHECK CYCLE NUMIiER ON HEADER CARD OR DSNAME ON mSFOOl CARD. 

This message will only occur in conjunction with CYCLE on the Main Mender 
Card if the cycle is greater than 1. It could be caused by attempting to run 
a new cycle when the preceding cycle had not run to completion or by attempting 
to repeat or start back at an earlier cycle without specifying REPEAT on the 
Main Header Card. The cycle number in bytes 1-2 of record 71 of data set 15 
must be one less than the Cycle number specified on the Main Header Card. (Seo 
section on the Logic of File Saving.) 
C. Errors in Additional Program Control Cards : 

Each Additional Program Control Card (input card set #3) is printed on the 
output for record purposes as it is read. If any errors are detected on any of 
these cards, an appropriate message will be printed immediately following the 
card image. A maximum of 10 errors will be detected by the section of the pro- 
gram which reads the Additional Program Control Cards. If more than 10 errors 
are detected the program will print: 

TOO MANY ERRORS. EXECUTION HALTED, 
and the program execution will be terminated. 

The following* errors may be detected: 
xxxx MAY NOT BE SUBSCRIPTED. 

The parameter specified as xxxx has been subscripted anci should not be; 
e.g. N0PLAY=ALLDEV(1) is incorrect. 

xxxx ^^UST BE SUBSCRIPTED. 

The parameters DEVELOPER, INDUSTRIALIST, POLITICIAN, PLANNER or their 
abbreviations must be subscripted. 

xxxx HAS AN OVERSIZE SUBSCRIPT. 

The maximiun subscript value for DEVELOPER and INDUSTRIALIST is (7) and for 
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POLITICIAN and PLANNIiR Llie maximum subscript is (3). 
xxxx IS UNDEFINED; 

The keyword or parameter xxxx is not a valid word. Probably miss[)ollc'd 
or incorrectly abbreviated word. Check the list in Chapter 2. 
^EXPECTED END OF FILE or * 
UNEXPECTED EOF 

These messages should only be printed if the program detects and "end-of- 
file** in the input deck before it finds a RUN or DATA card. An end-of-fi.le 
card for the input deck is the card with in the first two columns or the end 
of the input card deck. It might occur, for example, if you were running exact 
copies of the newspaper and had omitted the RUN card between the Main Header 
Card and the Newspaper Header Card. 

Normally the M.E.T.R.O.-APEX program terminates with one of the two follow- 
ing messages: 

NORMAL METRO-APEX JOB TERMINATION 
if no errors were detected in the entire program or 

METRO-APEX ABNOPJIAL TERMINATION WITH nn ERRORS 
Any occurrance of the mEYFECTED EOF message (and ABEND 0077) after either 
of the above messages should be disregarded. 
D. Errors in Reading the Main Player Decision Cards ; 

As the Main Player Decision Cards are read by the program error diagnostics 
are written on the printer under the line containing the image of the incorrect 
card. If there are any errors, or if you have submitted the job only to get a 
listing of the input data deck and have found errors not detected by the program, 
the errors must be correct and the job resubmitted specifying REPEAT on the Main 
Header Card . 

Each error message- is described briefly in the following paragraphs. 

Several errors are associated with project and program input cards. 
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ILLEGAL PROJECT NUMBER [n] 
If the number entered on a project or program card is not associaLi.*d witii 
any existing project or program, the above mossagc is priiitod, 
MISMATCH OF SCALE . . [n] 
Assignment of a project or program to a location which is larger (more in- 
clusive) than the scale indicated on the project list will cause this error 
message to appear; for example, coding 30 (Ward 1) for a project which must be 
assigned to a specific analysis area, 

MISASSIGNMENT OF AREA [n] 
When analysis areas are coded incorrectly, most often when projects re- 
stricted to a particular area are assigned to another area, this message is 
printed. 

*** PRICE (F-1) OUT OF RANGE 
When prices on capital improvement projects are outside the range speci- 
fied on the project lists, this error is printed. 

Another message may appear after a capital improvement or program card. 
FIELD 12 (LOC) CHANGED TO [n] 

This message is not an error . Assignment of a project or program to a lo- 
cation which is smaller (less inclusive) than the scale indicated on the projec 
list will activate a mechanism within the program to change that location auto- 
matically to the proper larger scale and write, out this message. 

Errors in the balance of the input cards will trigger the following diag- 
nostics. 

NUMERICAL VALUE [n] IMPROPER *** ^ 
An entry on a card that is clearly impossible (for example, a /zero entry 
for a player number) will trigger this message. The number [n] indicates 
which of the 12 possible numeric fields is in error. 
NON-GAME LD OR IND 
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If a developer or industrialist number appears on a card but is the number ol 
a non-playing developer or industrialist due to inclusion on a NOPLAY card, 
the above error is printed. 

*** ALPHA CODE UNKNOWN *** 
If the computer can not interpret the first two letters on a card, the 

above message is printed.^ 

si': r. 

*** BR/SR COMBO WRONG 

If, on land transfer cards, the buyer and seller are the same, the above 
message is printed. 

*** INCORRECT BOND/MILL NO. *** 

This message is written in one of two cases. If the card requesting a 
bond or millage issue (BS card) is not read prior to the project or program 
request (CP or SP card) tied to that bond or mill or a campaign contribution 
to that bond/mill, this message will appear. Rearranging the input to 
place the BS card before the CP, SP or CC^^rd (s) will rectify this error. 
The error is also caused if the first digit of the bond/mill aumber is 
not the same as the cycle number; i.e. in cycle 2 the bond/mill numbers 
must be 201, 202, 203, etc. 

*** MORE THAN 20 BONDS/MILLS, ABOVE CARD IGNORED *** 
If more than 20 requests for Bonds or Mills are processed in a cycle, 
the above message is printed. It may be corrected by either omitted the card 
or cards over 20 (not a very desirable solution) or, preferably, by com- 
bining one or more bonds or mills of the same type for the same jurisdiction 
into a single larger bond issue or millage. If you do make corrections of 
either type, don't forget to check the CP, SP, and CC cards for references to 
the BS cards which were eliminated. 

One more error message is printed in response to problems on cards 
dealing with land transactions. 
*** COMBO IMPROPER *** 
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F. Errors in Reading Issue Decisions : 

A subroutine, DECOD, is used to scan and LnterpreL Issue decisions (aiul 
CEM input cards) of the form iila (bbb). DECOD searchcK for Syntax errors 
only. The only legal characters which may appear on an Issue decision card 
are: 

blank 1234567890(),* 
If a character other than the above is found, this message is printed. 

ILLEGAL PUNCH IN COL [n] 
This message indicates the column containing the invalid character to assist 
the operator in making the needed corrections. Since the maximum number of 
digits in a single string on a card is four and the minimum is one, a check is 
made for excessively long and short combinations. Strings of unacceptable 
leii ♦'h result in either of two messages. 

MORE THAN 4 DIGIT NUMBER, COL [n] 

LESS THAN 1 DIGIT NUllBER, COL [n] 
If only one digit is found between two commas, it is assumed to be an alterna- 
tive number with no preceding issue number and results in the following. 

ZERO ISSUE NUMBER 

Note, that no column number is given — the operator must scan the incorrect card 
for the error. 

Whenever a right parenthesis is encountered, the program checks that 

there was a preceding left parenthesis. The failure to pass such a check re- 
sults in the following. 

WRONG PARENTHESIS, COL [n] 
The entire set of issue decisions on a single card is checked for errors 
before execution is terminated. After scanning the entire card, if any errors 
were found, the following message is printed: 
-k-k^ii-k nn ERROR(S) ON ABOVE CARD 
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Illegal combinations of use and zoning. For example, if use is vacant (code 
the zoning must be 1-6. If developed (code 1) , zoning must be 1-Jl. 

One last message may appear on the output as a warning of a potcuilial 
error. 

*** MISSING APCO COUNTY BUDGET CARD *** 

This is likely to be a serious error unless you are not playing the APCO 
role, since without a county budget allocation the APCO will have no money. 

The messages listed above are responses to errors in input found by the 
M.E.T. R.O.-APEX program itself — the program checks the cards for mistakes 
and inconsistencies and reports out any errors. Sometimes, however, -errors 
are made in preparing the input cards of a nature that prevents the computer 
from correctly reading the cards. these errors cause the computer itself to 
print diagnostic messages and take some action which depends on the Operating 
System generated at your installation. Probably the only error of this type 
which you are likely to encounter is the following: 

IHC215I CONVERT - ILLEGAL DECIMAL CHARACTER X 

This error results from having punched some character other than a decimal 
digit 0 through 9k a single plus or minus sign or blanks in an integer (I) 
field or the above characters plus a single decimal point in a real (F) field. 

The action taken depends on whether or not the Operating System at your 
installation was generated specifying what is known as the "extended error 
handling facility." If extended error handling is not in effect the system will 
halt when the above error is encountered. You must correct the error and re- 
start specifying REPEAT on the Main Header Card. If the system does have the 
extended error handling facility the problem is compounded. The system pints 
the diagnostic, performs what is known as the "standard f ixup" , which consists 
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of setting the value of the field in error to /2ero, ami conLinuos t»xot'uLioiu 
Since these errors aro iletectotl by the system prior to the rhcM-ks hy ihi* 
M.K.T.R.O.-APKX program it Is possible that the x.ero lit^lcl will bv del as 
an error by the main program and result in an error Lermination after readhi); 
all of the data cards. It is also possible, however, that the zero field will 
not be detected by the M.E. T.R.O.-APEX program during card input but that 
execution will continue witli the incorrect value. If this does occur you 
should check the encire output for possible errors as a result of this zero 
field and, if necessary, REPEAT the cycle, printing only the section of the 
output effected. 

E. Errors in Reading Newspaper Header Card ; 

The Newspaper Header Card is scanned for legal keywords in the same 
manner as the Main Header Card (Section B.). Only the first four characters 
of each keyword are considered. The legal combinations are: COPI, COPY, IGNO, 
RERE, NOHE, CEMI , NEWI. (See Chapter 3 for complete keywords.) If some four- 
letter combination other than the above is detected, the incorrect column is 
flagged and the following message printed: 

*** NOT A LEGAL KEYWORD ON NEWSPAPER HEADER CARD 
If a number followed by a comma is not detected following COPY= or 
COPIES= (probably due to a missing delimiter between the keyword and the numbe/"^ 
the following message is printed: 

*** ILLEGAL CHARACTER IN NUMERIC FIELD. COPIES SET EQUAL TO ONE. 
Note that the number of copies is not required on the Newspaper Header 
Card. If not specified the number of copies is set by default to one. 

If any errors are detected on the Newspaper Header Card the following 
message is printed and execution terminated: 

EXECUTION TERMINATED DUE TO ABOVE ERRORS. CORRECT AND RERUN 
Q SPECIFYING 'NEWSPAPER' ON MAIN HEADER 

ERIC 
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If there are no syntax errors on the Issue Decision Card(s) , the program 
checks the content of the cards. Two warning messages may be printed, 
MORE THAN AO SETS OF NUMBERS. STOPPED AT AO. 

The maximum number ot issues that can be stored at a single time is AO, 
Additional issues are ignored. The above message indicates that such "ignor- 
ance" is present. 

WARNING ~ NO TERMINATING CHAR. LAST NUMBER NOT STORED 

The last • character on each issue card must be either an asterisk or a 
comma. Any characters appearing on a card after the last comma (but not follow- 
ed by an asterisk) will not be carried over to the continuation card but will 
trigger the message printed above. This is only a warning iuas much as the in- 
complete issue entry triggering the message may be restarted on the continuation 
card without deleting the partial entry from the first card. If the incomplete 
entry is not repeated, it is, in fact, an error. 

In the absence of warnings and/or syntax error messages, a series of 
messages may be printed indicating that the entry for a given issue is invaJid, 
If the issue number is not within the 1-300 range, does not correspond to an 
init alized entry in the data file, or has an incorrect alternative number 
associated with it, one of the following messages is printed. 
ILLEGAL ISSUE NO. [nnn] 
or 

ILLEGAL ALTERNATIVE (n) FOR ISSUE [nnn] 

If any of the above messages are printed the. program halts after printing: 

CORRECT ERRORS AND RERUN SPECIFYING /NEWSPAPjIR' ON MAIN HEADER CARD 

If bond or millage numbers are entered on the issue cards, the program 

compares the first digit of the bond or mill number to the cycle number. If 

they are not the same the following is printed: 

ILLEGAL BOND NO. (nnn) FOR ISSUE m 
IGNORED IN SUBSEQUENT PROCESSING 
Note that the above does not terminate processing but is a warning only. 
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After all of the above checks, if no errors are detected, the progrcim 
compares the list of issues read from the issue decision card with the list 
of issues from the preceding newspaper which had possible linkages to other 
issues. If the program does not find a decision for those issues the follow- 
ing is printed: 

*MISSING DECISION FOR. ISSUE n 
for each such missing decision. If you had specified IGNORE on the Newspaper 
Header Card processing will continue. If you had not specified IGNORE, the 
program will terminate after printing: 

*** "IGNORE" NOT SPECIFIED. PROCESSING TERMINATED DUE TO MISSING 
DECISION(S). 

One last message may appear after reading the issue decision cards. The 
program saves the record of the decisions from cycle to cycle for use in 
processing the candidate election model. A maximum of AO issues can be saved 
from election cycle to election cycle. If that number is exceeded, the fol- 
lowing is typed. 

MORE THAN 40 ISSUES FOR CEM, nn IS IGNORED 

This error is not disastrous. Because it is possible to input a special 
set of issue decisions for uhe Candidate Election Model, the issue list can be 
edited (lo eliminate repetitions') when that model is executed. 
G> Errors in Reading Candidate Election Model Input : 

The input stream recording the candidate decisions on issues is scanned 
by the same DECOD routi'ie that interprets issue decision cards. Therefore, 
any or all of the syntax errors described in connection with the issue decision 
cards may appear in response to errors in the candidate decision cards. 

In addition, a series of straightforward error messages may be printed.* 
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ILLEGAL PLAYER NUMBER nn 
This is printed if the player number is less than 1 or greater than \U, 

ILLEGAL OPPONENT TYPE FOR CANDIDATE an 
This is printed if the opponent type for LncumjcnL c.ards (pJayor ntimber 
is not 1 or 2. It also appears if the simulated opponent type on the opponent 
cards (player number 9-16) is not a digit between 1 and 9. 

DUPLICATE PLAYER NUMBER nnn 
This message signals that more than one set of cards was entered for player 
nnn. 

NO MATCHING CANDIDATE FOR CAND. nnn 
For every incumbent card read (candidate number 1-8) a corresponding opponent 
card (candidate number 9-16 with 1 paired to 9, 2 to 10, etc.) must be read. 
A mismatch in pairing triggers this last message. 

If any of the above error messages are printed, the program terminates 
and the errors must be corrected and the program resubmitted, specifying NEWS- 
PAPER on the Main Header Card, 

In addition to the above "fatal** errors, the following errors may be de- 
tected. They are not considered "fatal*' to execution because the indicated 
corrective action is taken, but they should be analyzed carefully for their 
effect on the Candidate Election and, if necessary, the cards should be correct 
ed and the NEWSPAPER rerun. 

PLAYER nn SPENT MORE THAN 1{E HAD (nnn PCT) , CliANGED TO 

FF. fff FF.fff . . . 
Th^ desigiiited player entered percentages totalling more than 100% in 
assigning his funds to stress the various issues. The program automatically ad 
justs this "oversight" by cutting the percentages back proportionally. 

WRONG PARTY SUPPORT FOR CAND. nn. SET=30.0 
This message appears if the value in columns 4-8 of the incumbent card is neg- 
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ative or greater than UO.O. (Warning only.) 

PERCENT OVER 100 FOR ISSUE nnn CANI). nn. SKT^lOO 
This is printed if the percentage appearing in parenthesis for a given issue 
(designating stress) is greater than 100. (Warning only.) 

ISSUE nnn FOR CANDIDATE nn NOT IN flASTER LIST ~ IGNORED 
The program verifies that all issues entered for a given candidate were in- 
cluded on a previous issue decision card or input specially. If no record of 
an issue is found, the above diagnostic is printed. (Warning only.) 



Chapter 5 

The FILEPIINT Utility Program and Other Options 
The FILEPRNT Program—Creating and Printing M.E.T.R.O^-APEX Files ; 

This utility program controls, by selective subroutine calls, all the 
necessary functions of initializing the **files" in data sets 14, 17, 18 and 
19. Normally all of the required data cards for creating all of the files 
are in a single input stream on magnetic tape with the appropriate control 
cards for this program separating the individual decks. This initial input 
stream also causes a printout of all of the files (except issues and head- 
lines) as they are created. 

Once the files are created, this program is used to print any of the 
files, including those in data sets 15 and 16, either for diagnosis of program 
errors or for operator or player information. Of particular importance, since 
a number of copies will be needed for each game run, is the ability to print 
lists of capital projects and special programs (File 6). It is nlso useful for 
the operator to have a list of preset Issues and headlines for each cycle and 
a complete listing of all issues and headlines (ISLST). . 

The program is executed using the same Job Control card set as indicated 
for the main METAPEX program in Figure 3 in Chapter 2 with the following ex - 
ceptions : 

1. Replace the word METAPEX on the EXEC card with the word FILEPRNT. 

2. (Optional) The FT09F0bl DD card is not necessary. 

3. The REGION*= size on the JOB card can probably be elirninated, depend- 
ing on the default region size at your installation. The FILEPR>IT 
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will execute in a region size of 80K for file printing. A larger 



region size will be required for initial creation I rom magnetic' t ape 



if tlie block siz(^ is 10,000 bytes. 



(rbis inlormalion will be snpplinl 



when the, |)rogram is delivered to your installation.) 



The control cards for the FiLtlPRNT program arc simple, involving a single 
keyword starting in column 1 on each card, in some cases followed by one or 
more decimal numbers. The following are the legal keywords and their mean- 
ing: 

MAKE n — this card indicates that the program is to make file n. 

This card is immediacely followed by the data cards to be read by the 
program to make file n, if required. (Files 35 and 36 require no data 
cards.) The only legal values for n are: 3, 5, 6, 21, 28, 30, 31, 32, 
34, 35, 36, 37, 38, 39, 53, 61, 62, 64, 63, 201, 203, 204, 206, 209, 211, 
237. (Files 5 and 209 are the same, the values are synonymous.) 

Note: the file creation routines for files 6 and 28 also require 
control cards in addition to those required by the main program. 
They will described in a following section. 
The formats for data cards required by the above file creation routines 
will be described in a supplementary document. 
PRINT n,m — print the contents of file n. The legal values for n are: 



1, 31. 41 



3, 6, 11, 12, 21, 28, 53, 513, 204, 206, 211, 201* 



4, 34, 44 



7, 37, 47 



8, 38, 48 



*PRINT 201 is the same as using the keyword ISLST. 



15, 35, 45 



Both print the contents of files 201, 202 and 203— 



16, 36, 46 



the so-called issue list. 



19, 39, 49 



20, 30, 40 
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22, 32, 42 

51, 61, 71 File 6 is the only file that is usually printod 

52, 62, 72 with any regularity. The format of most of the 
54, 64, 74 other file prints is usually meaningful only to 
58, 68, 78 programmers. 

5, 209 

511, 531, 541 

512, 532, 542 

Files 1, 31, 41 and 11 may be followed by at least one additional value, 
separated from n by a comma. This value designates the analysis area to 
be printed for files 1, 31 and 41 and the record from 1 to 50 to be 
printed for file 11. The reason is that a complete dump of either of 
these files is very lengthy and usually of little value. If m=^99 for any 
of these files the complete file will be printed. For example: PRINT 
1,23 would print only file 1 for analysis area 23. 

As many PRINT cards as desired may be Included in the input stream. 

ISLST n,m — print the issues, alternatives and headlines in files 201 and 

202. 

The parameters n and m are optional. If omitted the entire list of issues 
will be printed. If specified n is the first issue to be printed and m 
is the last. For example: 

ISLST 1,10 will result in printing only the first ten issues. 
ISLST 101 Would print all of the issues from 101 to the end. 

Note: the issue file (#201) contains a maximum of 300 issues. At 
the present time only about 180 are used, allowing for future addi- 
tions. Only those actually in the file will be printed. There is 
room in the headline file (//203) for 1498 headlines. Many of these 
headlines are printed as part of issues. When all issue related head- 



lines have bi^cMi prinLiid, the program will coiUimio witii tiu^ li.il.uwi* 
of the '^one-liners*' which have not already been prinLed as part ol 
issues or alternatives. At the end, the program will list the 
numbers of issue records and headline records which have not yet 
been used and are available for expansion. 

BKVIN — this calls a special routine which does a final initialization of 
^iles 30 and 34. There are no data cards for this routine. It must be 
run following the original creation of files 30, 31, 32, 34 and 64 from 
cards. All of the mentioned files must already have been created when 
BKVIN is run. It should not be used except in very special cases. 

NOPRINT — the main FILEPRNT program is set to automatically call the print 
routine corresponding to a particular file following the use of a MAKE 
control. There may be circumstances when you may not wish to get a com- 
plete dump of all files created. The NOPRINT keyword card turns off this 
automatic print feature. It may be used preceding any >1AKE card and re- 
mains in effect until: 

PRQN — this keyword, an abbreviation for PRintON, turns automatic printing 
back on following the use of NOPRINT. 

FINISH — ns many of the above control cards as desired may bo Included in 

a single run of FILEPRNT. The last card in the input deck must be FINISH 
to indicate the end of the input deck to the program. 

Control Cards for Creating and/or Printing Filg; 6 — Capital Projects ; 

A special section of the FILEPRNT program facilitates the addition of or 

changes to the file of capital projects and special programs. It also allows 

deletion of projects and/or programs when they are no longer needed. Once 

added, a new project or program should remain in the file for the balance of 

the game; however, all new projects should be deleted from the file prior to 

the initiation of a new game run. 
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Note tliat since tlie FILEPRNT program is entirely separate from the main 
METAPEX program it must therefore be executed before ro-^ning METAPHX for any 
cycle in which there is to be a reference to a nev; prrject or program. The 
input to this special program is made froin cards punched with the following 
format. 

Project Card* 
Format Item and Code 



Cols. 

1-3 

4-5 



6 
7 



8 
9 

10-14 
15-23 
24-32 
33-77 



13 
12 



II 
IJ 



II 

II 

F5.0 
F9.0 
F9.0 
45AI 



Three digit integer projecL mimher (1-120) 
Location: Ol-29 for SperiFir y\nalysis Area (A. A.) 
30 f or-* any y\.A. , 31 for any Ward 
32 for any Jurisdiction 
Type: 1 = Streets, 2 = Sewers, 3 = Water, 4 = Parks 

and Recreation, 5 = Miscellaneous 
Capital Plant Index Impact: 0 = A. A,, 1 = Ward, 

2 = Jurisdiction, 3 = 
County 

Years to Construct 

0 if Revenue Bond Financing is not allowed, 1 if Lt is. 
Acres required (Real number with decimal) 
Total Minimum Cost (Real number with decimal) 
Total Maximum Cost (Real number with decimal) 
Project Title 



Program Card* 



Cols. 



Format 



Item and Code 



1-3 

4-5 
6-7 



8-10 

11-20 
21-68 
69-70 
71-73 



13 
12 
12 



13 



FIO.O 

48A1 

2X 



Three digit integer program number (1-40) 
Number of years program is to run 

Location: 1-29 for a Specific Analysis Area (A. A.) 
30 for any A. A., 31 for any Ward 

32 for any Jurisdiction and 

33 for County-Wide 

Required project number (leave blank if none is re- 
quired) 
Cost per year 
48-Characttr Title 
Blank 

Number of issue to be printed during the last yeai 
of the program (usually blank for additions) 



.J 

*A11 integer fields (I'^ Formats) must be right justified. 
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, The control of the program for inserting or doLoLjng or prinling 
projects is by means of keyword control cards which are in addition Lo Lliuse 
required by the main section of the FILEHINT program. They are: 
INITIAL — this should only be used when you wish to completely wipe out all 
projects and programs in the file and completely reload the file. It 
. does not result in reading any cards, it simply clears the file. It 
mus '56 followed by additional control cards to read new data, 
• PROJECTS ~ this indicates that the cards which follow are capital project 
cards punched according to the preceding format. The last card in the 
deck of project cards must be blank to indicate the end of the project 
card deck. 

PROGRAMS' — this control card indicates that the cards which follow it are 
special program cards punched according to the preceding format. 
The last card in the special program deck must be blank, 

DELETE n,m,i, n — this card contains a list of projects and/or 

programs which you wish to delete from the file. Each number must be 
separated from the next by a comma. Note that special programs must be 
number from 121 to 160 . 

REPLACE — norraily when adding projects and/or programs the program will 

indicate an e^rror if a record with that number already exists in the file, 
assuming thil you do not wish to destroy a record that already exists. The 

c 

above control, card may be used preceding a PROJECT or PROGRAM control 
card to allovv replacement of records which already exist. 
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LIST n — this control card will result in the priatliig ui* n copiers ol 
the project/program list. The default if n is not specified is one. 

STOP — this card must be used to indicate the end of all control cards related 
to file 6 and causes a return to the main FILEPRIIT program. ' , i.^ 

Running More Than One Game: 

Some organizations using M,E,T,R,0,_APEX may need to be able to process 

more than one run of the game at the same computer installation concurrently. 

The reasons for this can be many short demonstration runs overlapping long- 

term runs, more than one course using the game during the same semester, 
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training sessions for operating staffs each of which is advising a (iiffcront 
team, or running for very large groups where the group is divided into two or 
more teams - 

The IBM 360 computer program for M.E.T.R.O.-APEX can be used to run as 
many teams as necessary, although we recommend that uo more than five game 
runs be in progress at any one time since the file handling becomes rather 
cumbersome for more than five teams and can lead to unintentional errors. 
The procedure for up to five teams is extremely simple, since it only in- 
volves keeping two additional data files for each extra team. 

Chapter 6, M.E.T.R.O.-APEX Data File Organization and Description , has 
discussed in detail the six "permanent" data sets used by the M.E.T.R.O.- 
APEX/360 program. It was noted that data sets 14, 17 and 19 contain files 
which are "read-only" within the main program (the data may be changed for 
special purposes by the FILEPRNT program) and are shared by all teams. Data 
set 18 contains variable records of issue and newspaper decisions, however it 
is set up to handle records for up to five game runs automatically and no modi 
fication to the standard Job Control set is required for running from one to 
five teams. 

Data sets 15 and 16 are the critical data sets from the standpoint of 
multiple teams. Each team must have its own pair of data sets 15 and 16. Be- 
fore running the game for any team for the first time, data sets 15 and 16 
must have been "pref ormatted" by running a special job which .creates the two 
data sets by reserving space on a disk volume for them, names them and runs 
a program which writes the team number into a specific place in each of the 
two data sets (bytes 75-76 of record 71). An example of this job is shown in 
Figure 8 . When the main program is executed, the team number specified on 
the Main Header Card is compared with the team number stored in one or both of 
these data sets and, as noted in the chapter on Error Messages, execution will 
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JOB TO PREFORJtAT TEAM FILES 



7/NEWTEAM JOB ( 9224 1 20 i APEX ) t PRATT t CLASS = E ♦ T iMF= 1 <— L'jc- 

//STEPl " ... EXEC , F0RTGCL6 _ apprvprt/d^t TOQ <u>^rd . 

//FORT.SYSIN DD * fcM yjur ;ns+*.|l*-tJort. 

C \ ! 

~C MAIN PROGRAM TO PREFORMAT NEW TEAM FILES ' ' 

C . PLACES TLAM NUMBER IN PRQPER_L0CAT10N J N _DAT A_SEJS 15 AND 16 

c . " " ' .". , ' 

C USE ONLY FOR CREATING NEW DATA S'ETS FOR ADDIT IONAL TEAMS 

C ONCE CREATED THE TEAM NUMBER WILL REMAIN UNTIL JHE DATA SET 

C ; IS SCRATCHED FROM THE DISKt 



IMPLICIT IN.TE6ER*_2 (J^jN) 

DEFINE FILE 15 ( 305 » 160 tU sKXl 5 f 
DEFINE FILE 16 ( 225 t 160 tU tKX16 ) 



DIMENSION A{ 160) »NEED(40I 
EOUIVALENCEC A( 1 ) tNEED< 1) ) 



DO 10 I=ltl60 
10 A{ I ) =0.0 

bo 20 I=l»225 ■ 

WRIT,E{15'I) A 
20 WRITE (16*1) A " 

00 30 1=226.305 
■•T0~v;RITE1 15 ''IT' "A 

PFAD(5fl) NTEAM 
1 FORMAT ( 11) ■ " 

IFCNTEAy) 100»106t40 
40 IF(^lTEAM-5) SOtSOtlOO" 
50 NEED(3R)=NTEAM 



WRITE 1 15 '71) NEED ^ 

WRITS {16 '71) NEED .CitaP6* to. CrOrre<,r^J^,sK 

CALL EXIT _ It* m* s n<xmh&i- ccir 

1 ._ year i ws-fr^. liaj't i on , 

INVALID TEAM NUMBER ^- • - /■ - h i 



100 WRITE (bt2) NTEAM 

2 FORMAK 'O*****' IS INVALID TEAM NUMBER') 

CALL EXIT 
END 

/* ■ , 

//G0.FT15F0G1 DD UN I T= 23 14 1 D I S P= ( N EW »K EE P ) »SPACtV( 6>tC i 
/ / DCB= ( RECFMep i E-LKS I ZE = 640 ) t \/0L = Si:R'fKiEC6}hDZff= ^ I Li 1 . . . 

//GO.PT16F001 OD UN I T = 2 314 .0 ISP= < NEW fKEEP-) ♦SP,A_CFs/640. ( 22 5 !) , 
// DCB=(ReCFM. = F»BL"KSl'Z£ = 6'^0)»Y0 

//GOoSYSIN DD * i= Tf'-* 

-1*.. L» Coi' ioj- -tiis 1+ «;lidi.if/i- 
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be terminated if tlie team numbers do not agroc?. 
Data Set Numbers vs. Data Set Names : 

A number of references have been made above and elsewhere in this volume 
to data sets by number; for example, data set 15, etc. This has been convenient 
for explanation but it is not s^rictly correct terminology. The following 
definitions will help to avoid confusion in the discussion which follows: 

Data Set ; An organized collection of related data residing on somo storage 
medium; for the -M.E.T. R.O. -APEX program it is normally stored on a direct ac- 
cess volume, usuaJly a disk pack. 

Data Set Name : Each data set is assigned a name at the time it is cre- 
ated and that name is used thereafter to refer to that particular data set. 
The name is specified to the Operating System on a DD card by meant* of the 
parameter DSNAME= or its abbreviation DSN=s. Each data set on the same disk 
volume muFC have a unique name . An unqualified name consists of from 1 to 8 
characters, the first of which must be an alphabetic character. A name may be 
qualified by appending to it a period followed by a qualifying name of [rom 
1 to 8 characters, the first of which must be alphabetic. For example: 
FILE15 is an unqualified name. 

FILE15.TEAM1 is a qualified data set name.^^^^ 

^^►are unique names. 
FILE15.Team2 is a qualified data set name."^'^ 

Additional qualifications may be appended, subject to the same rules, up to a 
maximum of 44 characters. For example: 

FILE15.TEAM1.CYCLE4 is a legal data set name. 
Notice that there may be no embedded blanks in a data set name. 

Data Set Reference Number : Within the computer program there is no re- 
ference to any specific named data set for reading or writing data. Instead 
the program refers to a data set reference number — it is this data set refer- 
^ ence number (abbreviated DSRN) that is frequently used in this volume to refer 

ERIC 
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to data sets. The actual named data set to which any number refers is noL 
known to the program until it attempts to road from or wrilo iuto l\\c dal.i srl . 
Then the Operating System supplies the program with the actual location oT'Chr 
data set which it obtains from the DI) cards supplied to it as part of the Job 
Control Cards. The connection be jween the data set reference number in the 
program and the data set reference number on the DD card is coded within the 
DDNAME, that is, the FTnnFOOl in columns 3-10 of each DD card, where nn (the 
third and fourth digits) is the data set reference number. 

From the preceding definitions, it follows that it is tb job of the 
person preparing the input data deck for a rur. of a cycle of M.: .T.R.O.-APEX 
to keep track of and specify the correct combination of team number on the 
Main Header Card and data set names (DSN=) for that team for data sets 15 and 
16 on the corresponding DD cards. For this purpose it is recommended that 
the naming convention used in creating data sets for new teams follov/ some 
easily remembered and coded pattern, such as FILE15.TEAM2 as used in :he pre- 
ceding examples. 

As previously noted, any number pf teams can be run concurrently. How- 
ever, the team numbers must be from 1 to 5 since five teams are the maximum 
that can be accomodated by data set 18. 

It is extremely unlikely that any organization using M.E.T. R.O.-APEX 
will have any need for more than five teams, but in the rare event that it should 
become necessary the following notes are included: 

For each additional set of five teams one additional data set "18"' v>;ill 
be required. You will then need to become more sophisticated in data set naming. 
It is suggested that you use the convention of adding a letter to the data set 
names for the additional 15, 16 and 18 required: 
FILE18A and FILE18B 

FILE15.TEAM1A and FILE15.TEAM1B. . .FILE15.TEAM53, etc. 
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Remember that tUu team number 'jn iho. Mnin lluader Card must sL.'ll 1)^' onlv u 
dig! t from I to i^o alphabet i cs arc* allowcML ll htn'omes (»xt rcnic 1 v i mpo rl an i 
to keep ^',00(1 rcuords and to earefi^lly riiuck Llie 1)1) cards In thr lob ('.unM'ul 
set for proper correspondence between data set names and team number. There 
is no protection in the main program to prevent using the files for TEAMIA 
when TEAMIB was intended , and vice versa. 
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Chapter 6 

M.E.T, R>Q>-APEX Data File Organization and Description 
I ntroduction : 

The disk *'files" for M.E.T.R.O.-APEX contain and are used Cor throe basic! 
types of "data": 

1. Actual land use, budget, population, etc, tables used to initialize 
the game and which are then updated from cycle to cycle as play pro- 

* gresses. 

2. Tables of constants, conversion factors, and alphabetic character 
strings used for output. 

3. Arrays of values saved temporarily during a cycle to make room for 
other data in core and then retrieved for further processing. 

File Organization : 

The files are organiised by number into six direct data sets. The term 
"file" as used in this volume refers to a consecutive group of records within 
a data set which have the same length and variable attributes or are other\57ise 
logically related. The six data sets have specific usages: 

1. Data set 14 consists of fifteen "files" 'containing the "cycle 0" data 
base; that is, the tables and other variables representing the initial 
state of the game. It is r Terred to qnly when starting a NEWGAMU by 
running cycle 1. The files in data set 14 are created by and, if 
necessary, are modified only by the FILEPRNT utility program. None 
of the files in data set 14 are ever written into by Lhe main i'DiTAPEX 
program. 
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2, Data set 15 is the ^'working" tlala sol diirinj; Lho proit'ssin^ o\ a rv* ;* 
of the game. That is, it contains the accounts and sLoros oi tiu' 
various game roles which are added to or subtracred from or otherwise 
modified by the main section of the METAPEX program. It consists of 
18 "files'*, the first 15 of which correspond to the 15" files in data 
set 14, the last three files are "temporarily-permanent''; that is, the 
are used only during the processing of a single cycle but are retaiiUM 
for possi. value in tracing errors if any should occur. 

3. Data set 16 consists of 15 files and is exactly analogous to data set 
14 except that it contains " preceding cycle" records. Data set 16 is 
not changed during the run of a cycle, but is retained for comparison 
with data set 15 at the end of the cycle. 

A. Data set 17 consists of five files containing constant data which is 
"read-only" by the main program. Included in this set of files is th 
list of capital projects and special programs which may be modified 
by the FLLKPRNT program. 

5. Data set 1 8 consists of sixteen files which, with one exception, are 
used only by the issue, candidate election and newspaper processing 
section of the main program. The one exception is the list of exo- 
genous industries which is used by both sections o*^ the program. 
Several of the files within this dataset are subdivided into groups 
of records sufficient for recording up to five game runs (teams) con- 
currently. 

6. Data set 19 consists of three files containing issues, alternatives 
and newspaper headlines. It is a read-only data set. 

Chapter A, Error Messages , discussed the interaction of data sets 14, 15 
and 16 during a game run. Because of its importance it will be repeated here. 
At the beginning of a game run, when either NEWGAME, CYCLE«1 or REPEAT=1 
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is rptM- i f i i»tl on Miidi Ik^adcr Card, Mu' lilli'cii lilos in vlai.i .sci 1 . .iir 

copied into bntli data sets 15 and IT). When LlUs copy (operation ha:; hmi snr ■ 
cessfully completed the program prints Lho message: 

DATASETS 15 MiU 15 HAVF. BI-EN INITIALIZED FOR NEW GAME 
At this time the cycle number in bytes 1 and 2 of record 71 of each of these 
three data sets is zero* 

At the end of a uormal termination of the main part of t:ho program (indi- 
cated by either going on to the newspaper and issue section or by a normal 
termination message if tlie newspaper is suppressed) the cyc le number l i data set 

15 is set equal to the number of the cycle just completed. 

When CYCLE== i (i greater than 1) is specified or tlu! Main Header (!ard 
data set 15, the record of the last cycle completec, is copied into data set 

16 and when the copy operation has been successfully completed the following 
message is printed: 

STATUS AT END OF CYCLE i HAS BEEN COPIED FROM DATASET 15 TO DATASET 16 
^FOR START OF NEW CYCLE, 
Whea REPEAT=i (1 greater than 1) is specified on the Main Header Card data 
set 16, the record of the cycle preceding the last* one completed, is copied 
into data set 15 and when the copy operation has been successfully completed 
the following message is printed: 

DATASET 16 HAS BEEN COPIED TO DATASET 15 FOR RErEAT OF CYCLE i 
Notice that at the beginning of the main section of the program data set 
15 and data set 16 both contain exactly the same information. 
File Record Length and Format : 

The following six DEFINE FILE statements are included in both the root 
section of the main METAPEX program and the FILEPRNT utility program. 
DEFINE FILE 14 (225, 160,U,KX14) 
DEFINE FILE 15 ( 3oT^T60^yKX15) 
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DEFINE FILE 16 (225, 160,U,KX16) 

DEFINE FILE 17 ( 358,94 ,U,KX1 7) 

DEFINE FILE 18 (986 , 116 , U, KXl 8) 

DEFINE FILE 19 (2100, 30,U,I(X19) 
Not all of the records within each data set utilize the maximum record longtli 
specified in the above define file statements* Where there is a discrepancy 
it will be noted in the discussion of each individual ''file*" 

As noted earlier, each "file'' is a group of consecutive records within 
a data set. In order for the program to reference the records within a "file" 
from 1 to n each direct access READ or WRITE statement witliin the program uses 
the algorithm (n+NRxx) where NRxx is an offset value for that "file" which 
is one less than the first record of "file" xx within the data set. 'Hiose 
offset or base record numbers are set in a BLOCK DATA subroutine and commusu- 
catefi to the program in a named COMMON block 9 /FILES/ . 

Each "file" is individually numbered for reference by the program and 
within this description. Table 1 is a cross-reference index to file numbers, 
data set reference numbers and records within a data set. 

Table 1 

CROSS-REFERENCE LIST OF M.E.T.R-O.-APEX FILES 



File 


Is in 




Maximum Record 


Number 


Data Set 


Records 


Length (Bytes) 


31 


14 


1-58 


640 


34 


14 


59-64 


640 


3/ 


14 


65-67 


640 


38 


14 


68-69 


640 


35 


14 


70 


328 


36 


14 


71-78 


80 


.19 


14 


79-81 


640 


30 


14 


• 82-98 


640 


32 


14 


99-100 


640 


61 


14 


101-163 


96 


62 


14 


164 


624 


64 


14 


165-171 


464 


68 


14 


172-223 


56 


531 


14 


224 


348 


532 : 


14 


225 


134 
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Table 1 (continuecl) 

File Is in Maximum Uccdrd 

Numl)cr D.iLa Se_t. l{e cords l.cin;Lli X'.l>'.'-''-''A 

i 15 J-58 f./(0 

4 15 59-64 640 

7 15 65-67 640 

8 15 68-69 640 

15 15 70 328 

16 15 71-78 80 

19 15 79-81 640 

20 15 82-98 . 640 
22 15 99-100 ' 640 

51 15 101-163 96 

52 15 164 624 
54 15 165-171 464 
58 15 172-223 ^ 56 

511 15 224 348 

512 15 225 134 

513 15 226-254 636 
12 15 255 640 
11 15 226-305 640 

41 , 16 1-58 640 

44 '- 16 59-64 640 

47 16 65-67 640 

48 16 68-69 640 

45 16 70 328 

46 16 71-78 PT 

49 16 79-81 ^0 
40 16 - 82-98 640 

42 16 99-100 640 

71 16 101-163 96 

72 16 164 624 
74 16 165-171 464 
78 16 172-223 56 

541 16 224 348 

542 16 225 134 

3 17 I 1 232 

21 17 " 2 376 
6 17 3-162 72 
28 17 163-278 58 

53 17 279-358 80 

204 18 1-10 64 

. 205 18 11-20 12 

206 18 21-30 40 

207 18 31-35 290 

208 18 36-40 120 

209 18 41-88 56 

" 210 .18 89-688 ,240 

211 18 689-698 ' 256 

212 18 699-703 464 
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'i' able L (cont : i j \ i an i ) 

Kilo Is in Maximum lUMnwd 

Number Data Set ivecords f.ength (By L <'s) 

217 18 704-708 290 

237 18 709-716 290 

247 18 717-731 256 

101 18 732-821 80 

102 18 822-901 160 

103 18 902-981 28 

104 18 982-986 32 

201 19 1-300 88 

202 19 301-600 76 

203 19 601-2100 120 



In the description of each file which follows, the "words" reforrc^.d to 
are two bytes long, the length of all integers in M.E/f.R.O.-APEX, or an IBM 
360 half-word. The type of variable is abbreviated I for Integer •*2 and R for 
Ifeal*4 unless otherwise specified. The element numbers given are for use in 
making file changes. For integer variables the element numbers and word num- 
bers are the same. For real variables the element number is half the even 
word number. 

For convenience, the file descriptions are in numeric order from 1 to 5L*J. 
Since the first fifteen files in data sets 14, 15 and 16 have iL.entical de- 
scriptions they are listed by the data set 15 number which is the first valui' 
in the following list: 
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Dataset 




Dataset 


15 




14 




16 


1 




31 




41 


4 




34 




44 


7 




37 




47 






38 




48 


15 




35 




45 


16 




36 




46 


19 




39 




49 


20 




30 




40 


22 




32 




42 


51 




61 




71 


52 




... g2 ■ 




72 


54 




64 , 




74 


58 




68 




78 


511 




531 




541 


512 




532 




542 
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FILES 1, 31 and 41 : 

These files contain land-use ownership, value and price data which vijlTe^rs 
in each of the 29 E. T, R. 0, -APEX analysis areas. A logical record for each 
analysis area requires two physical records, accounting for the 58 physical 
records in the file. The word count given is the sequence within each phyt^Lca! 
record. The following variables are for one logical record, they are identi- 
cal for each analysis area. 



Record ill 



Words Elements Type 



1-35 



36-70 
71-75 



81-85 
86-90 



1-35 



36-70 
71-75 



/6-80 76-80 



81-85 
86-90 



I 
I 



Name 



BDR (5, 7) 



INDR (5, 7) 
MDR (5) 



PDR (5) 

CDR (5) 
QR (5) 



Number of developed units of each of 
the five residential housing types 
owned by each of the 7 game realtors, 

(Game Realtors) Developed Residential 
Units 

By rules of PORTRAIT storage the firsr 5 
values (words 1-5) are for realtor 1; 
the next 5 (words 6-10) for realtor 2 
and so on. The 5 values represent, in 
order of storage, the 5 developed resi- 
dential zoning combinations in the 
following order: Rl, R2, R3, K\,.mr^ 

\' 

Same as above for up to 7 industrialists. 

Same as abov^ for rest of private sec- 
tor (market) , 

Market Developed Residential Units , 

Same for the municipality (either real 
or simulated) , depending on the analysis 
area. 

Same for county. 

Empty residential units in each of the 
five categories. This is a subset of MDR 
that is MDR includes both occupied and 
empty dwelling units. This array con- 
tains values as a result of emigration of 
families from an analysis area and is 
used to meet demands not met by realtors 
in the case of immigration or for sales 
to realtors and the public sector. 



S2 



Words t Elements Type 



Name 



91-95 91.-95 



I KMF (5) 



96 

9 7-180 49-90 



"181-264 91-132 



265-276 133-138 



277-28JJ 139-144 

' — • ■ ■ V . 

I . - 
289-300 145-150 

301-312 151-156 
313-318 151^159 



IFIL 

BDC (6, 7) 



R 



R 



R 
R 
R 

R 



INDC (6,7) 
MDC (6) 



PPC (6) 
CDC (6) 
QC (6) 

P .(3) 



319-320 160 



U 



jC^mlj^ratocI J\;iini. 1 ics (formerly 1' .irrnv in 
MICTRO) . F.nnilliivs Io:n/inf^ H ()^(»iU'r;il 
rruirkot r(»s i dcnl i n I ) mn'jrix in I lit^ ;in;ilv- 
sis-^/iroo, i)y zoning; Ly pc. A(l(k»tl to: 
(.1) when market sells more developed 
J residential units than are empty ((JR. 
array), i,e,, occupied dev. residential.; 
(2) when market developed residential, 
land is rezoned, thereby causing It to 
become vacant. It is not initialized' 
and is set to zero at beginning of each 
cycle. v-r^ 

2-byte filler for boundary alignment. 

Realtors developed commercial industrial 
and agricultural acres. 

_B (Game Developers) Developed C^ommercial 
property in ac res . 

Developed Non- residential Zoning: 

1 - CL^ Local Commerce 

2 - CR, Regional Commerce 

3 - IE, Endogeneous Industry 
^\ - IX, Iixogeneous Industry 

.5 - OD, Exogeneous Bureaucratic 
6 - AD J Developed Agricultural 

Industrialists developed iridustrial and 
.commercial* ^t^r^ 

■ • r 

Market Developed C^ommercial and indus- 
trial property in acres . 

. This array does include acres devoted 
to developed exogeneous commerce and 
industry. ' . 

P^ublic developed C^ommercial. . 

C^ounty developed ^Commercial. 

Empty developed "commercial*" This is 
a subset of MDC (1), MDC (2) and MDC (3) 
in the same way QR is a subset of J-IDR- 

Public developed property: 
P (1) - Municipality 
P (2) - County 

P (3) - Right of way and st'reets- 
Base density, factor for i*:V>>i!.nT' resi- 

Ji- • y • . ... 
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Words Elements Type 



Name 



'dentlal. This value ls Die uni I per 
-r^cre for zho, least dense /.onlnj^ caLtigfjry 
(R]^) in tlie particular aaalysis aren. 
It is stored as the reciprocal. For ex- 
ample, 3 units/acre is stored as ,3333 
(1/3). (Multiplication factors for more 
dense zoning categories, which are con- 
stant across all analysis areas , are' 
stored in array UDENV (5) in File 21;) 

The values are used to convert from 
units to acres and vice versa. 

•f 

ACRES = UNITS x UDENV (TYPE) x U 

UNITS = ACRES/ (U x UDENV (TYPE) )• 

For axample, 9 units of R3 houses at a 
multiplier of 2 (,.5) in an analysis area 
T.Xth a base factor of .33 would require 
9 X .33 X c5 = 1.5 acres. 



APEX File 1, Record //2 
Words B ler^nts T ype 
1-84 . 1-42 R 



Name 



BVRC (6, 7) 



yJ&y (Game Realtors*) Vacant Residential 
and Commercial property holdings in 
acres. 



85-168 43-84 R 
169-180 85-90 R 



181^192 91-96 



R 



193-204 97-102 R 



The six zoning categories, in order of 
storage are: 

1 - Residential, single fcimlly R 

2 -■ Residential, multiple family M 

3 - Coinmercial C 

4 - Industrial I 

5 - Office 0 

6 - Agricultural A 

1VB.C (6, 7) Same as BVRC for game - Industrialists. 

MVRCr~(6) Saro as BVRC for non-game ."market 

This is^the balance of all vacant land 
' not/ in one of Che other VRC arrays. 

PVRC (6) * Same as BVRC for the municipality (pu]i- 
lie) in the AA. 

CVRC (6) . Same as BVRC for £Ounty in the AA. . 

Note: in 'some APEX routines, for ex- 
ample where we are summing all vacant _ 



HA 



Words Elements * Type 



Name 



205-216 103--108 R ' yVRC (6) 



land, cliL'sc? riv<! arrays are ri>ml)iiUMl 
and diiimn.sione<! as IWUC (6, 17). 'I'liis 
is permissible since they are a).) sLort'd 
consecutively by columns. 

Value of _Vacant: Residential and jCoiranercial 
Land in dollars per acre . These are the 
"appraised*' values printed in the large 
table at the^ end and used for all sales 
of vacant property and assessment. 

217-226 109-113 R VDR (5) Value of Developed Residential in dollars 

per unit of tlie 5 zoning . categories , 
through M2. T'his is the value used for 
assessing developed residential property 
av'l also the minimum sales price for 
sales of market de^'-eloped residrntial 
units to game. realtors. 



227-238 114-119 R VDCy (6)^ 



239-250 120-125 R ROWF (6) 



Value j)eveloped Commercial (and Indus- 
trial property in dollars per acre. 
Same as VDR except for the six comraerr.ial/ 
industrial categories < See note above.. 

Right-of-way (streets, sidewalks, ^tc.) 
factor for each of the six categories of 
vacant land. 



251-252 126 



R E 



The number of acres being developed is 

multiplied by the appropriate ROW factor 

to obtain the number of acres added to 

or subtracted from P (3) above. 

Note: Because right-of-v^ay is always sub- 
tracted from vacant acres used for, ^devel- 
opment, when developed land becomes 
vacant, ,the number of acres for right-of- 
way, is taken from* city and added to the 
vacant areas. . ' 

This is now a constant 1.0 for all AA's. 



ERIC 



253-254 127-^ R ADDTB 

255-276 128-138 R * PDRC (11) 



iilVEC (in file 21) contains cost per liriit 
or per acre for ekch developed type. ^ If 
.at" some tiuip. we con^rude that Improvement 
costs vary by M, the factor could be 
changed. > •. 

Added tax base for exogeneous property. 

Price of Developed Residential and Com- 
mercial property. These prices are only 
used for sales of game players' developed 
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Words -Klemeats Ty^)r 



-J 



l^ropi'Tly. Do I I ;mi jHMj (in i I Im Mh' Hij'.i 
13 vn I ut^*^- vid (Ml : ('() rrt'spyiiHl to t lu' '» |\ 
classes for ' s l/agii* fami' ly aiul tlifii i U:, ? i - 
pie family residential. Dollars ptit: acre 
fot the la-<=t six values which correspond 
to the six^ classes commercial, indus- 
trial and agricultural property :the game 
players may develop. Initial 6 percent 
over corresponding value. 



277-320 



88 unused bytes available foj^ e^jtransion. 
APEX File 3 - This, is a single record "file" in data set 17 containing constants 
for use by the TO MM model- - ■ 



Words Elements Typa 



1-58 



1-2S 



R 



Name', 

zn(29) 



59-116 30-58 



R 



ATOT(29) 



Maximum allowable density in persons per . 
' acre for. each analysis area. This Is 
used in the residential, loop .within TOMM 
model as a constraint on growth in an 
area 

^^To't'^l land ai'ea in acres^for each analysis 
area. This is used in TOMM wto compute ftihe 
available land for coiDniercial use by sub- 
tract. ;ig out. all bthef uses- 



APEX Fi-2res 4» 34 and A4 - These^iles each' require six physical records. They 
are best .described as government and .schools financial data. The data from, 
file 6 is retained in named COr^ON block /FILE4/ dtiring program execution".' 



Record #1 



Wo rds Elements- \ Type Name 
l-'2 1-2 ' J?' : NKK(2) 



' 3-12 / ;/2-6 



1,3-162 7-81 



ERIC 



R 



VTPP(5) 



TVBK(S; 15) 



Count .of- 10 word ^ond or millage records 
in sectors 4-5 (NKXXl) ) / Nl<K(2) is pre- 
sently unuvsed. / . . ^ 

Total assessed value of all "private^ pro- 
perty in each jurisdiction* Note that 
VTPPC5) . is the sum of 7/TPP(l) . V. VTPP(4)' 
and is total for. county. v 

Total appraised value of alltprivate 
property „ tor 'each of the seven ,lan-d 
•vvelopers (1-7J_,.. the seven 'industrialists 
(8-14) and the general market (5). in - 
each ' of . the^ 5 jurisdict|.'on,s. , . 
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Wor i is 


Eleraunts 




Name 


163-192' 


8y-96 




BKVrf 15) 


19>222 


97-111 


R 


3KDT(15) 


223-230 


112-115 


R 


ASSF(4) 


231-248 


116-124 


R 


TAM(9) 


249-266 


125-133 


R 


0PMIL(9) 


267-284 


134-142 


R 


AMS(9) 


285-302 


143-151 


R 


SPEC0(9) 


M3-320 


152-160 


R 


SPECD($) 


Record\j 


'2 






Wordsur 


Elements 


T^Ee 


Name 


1-18 ^ 


1-9 


R 


CLL(9) 


19.-36 


10-18 


;R 


SLIM(9) 


37-54 


19-27 


R 


BD0TG(9) 


'55-72 


28-36 


. R 


G0NEW<:9) 


73-90 


37-45 


R 


BDPG0(9) 


91-10^8 


46-54 


R 


DR]pOL(9) 



Toti^ value of varartt propo'rlv for (»a<'li 
of tlio J 5 i«. U'lnents of the prfvalo si^ctor. 

Total value of developed property for 
each of the 15 elements o*" the private 
sector. 

/ / 

Assessment factor for each of the four 
jurisdictions. 

Total assessment rcillage for each of the 
following jurisdictions: 

1-4 Municipalities 

5 County 

6-9 Simulated Schools 
This is used for computing tax due from 
private sector. It is the sum of A14S + 
SPECO + SPECD. 

Total operating millage. Sum of AMS + 
SPECO. 

Total Noxmal Operating Mills 

Total of Special Operating Mills in effect 

Tot/a^ of all debt retirement millages. 



109-126 55-03 



r27-lA4 64-72 



DRFGF(9) 
CPFND(9) 



Current Local Limit on operating' mil-Is . 

State Limit on operating mills . 

Total General Obligation Bonds Outstandiiig 

Total New GO Bonds this cycle.. 

' Total Minimum Pajrments Due Next Cycle for 
GO Bonds. 

Total dollars in debt retirement fund at 
beginning of c^cle. Generated from debt 
retirement millage + surplus fj:om las^'' 
cycle. Calculated for "this'* cycle in 
last cycle's jCutput links. 

Dollars for debt rett-riitent transferred 
f^oifi gei^eral fund in current cycle. , . 

Total dollars in. Capital Fund. At begin- 



Words Elements Type 



U5- 16 2 73-81 



163-lnSO 82-90 



181-190' 91-y5 



191-200 96-] GG^ R 



201-210 101-105 R 

1 ; 

211-220 106-110 R 
221-229 221-229 • I 

i 

I 

. ■ ' I ■•*■ 

230 I 
231-236 116- lia :^r^ 

237-238 119 R 

239-320 . 

File 4> Record //3 

Words Element s Type 
■ * ■ 

1-16Q 1-80 R 



Name 



TNEWB(9) 

CFTRN(9) 

BD0TR(5) 
BDFRV(5) 

CREDP (5) 

BLIM(5) 
CREDS(9) 

IWAST 
MTEI(3) 

REDUX 



Name 



ning of cycle the value in f lie j^A is 
that remaining from preceding cyrlr. This 
is a continuous total 'refl(?cting addi- 
tions from new bonds and transfers from 
general fund less amount disbursed to pav 

for projects. \ 

I 

Total new bonds this cyWe* Sum of ap- 
proved G-H bonds and all\^ revenue bonds. 

r^t-r./f.rj transferred to aap^^itai >udget from 
general f und^ this cycle. \ 



'Revenue Bonds Outstanding (no schools). 

i 

Total Payment due on revenue bonds next 
cycle. . j 

Percentage of state equalized valuation 
which determines GO bond limj.?:. 



GO bonci limit. 



Credit limiting for each jur|isdiction. 
Integer values 1 to 3. - | 

Filler for boundary alignment. *^ 



Interest rate on new GO bonds for the 
three ctedit ratings. | 

i I 

Reduction^ fa*. : or applied toj reduce CREDP 
when credit rating drons. i 

. ■■ 

.Unusrs*. ■■ • 



OPVEC(16,5) Operating budget percentage.^ 



or dollars 



ERIC 



of the 4 -municipalities and bounty (//5) 
carried from preceding cycle in file 44 
and tjo* next cycle iii file 4. ' Value will 
be negative, if a percent and^ positive if 
dollars. Columns are as follows for \ 
Municipalities (1-^4) ano County (5) : 

1 --Legislative, executive 

- (Note : this item will be ^carried 
a3. a dollar value whicfi cahnp.t - 
"* - Sropi It may only be increased 
by player inpjjt. 

2 - Planning 
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Words ^ Elements T ype 



Name 



3 - Financial 

4 - Judicial 

5 - Fire and Police (Public safety for 

county) 

6 - Parks and Recreation 

7 - Water and Sewage 

8 - Refuse collection 

9 - Streets 

.10 - Employees benefits 

11 - Public relations 

12 - Library 

13 - Public health (county only) 

14 - APCO (county only) 

15 - Welfare and hospitalization (county 

only) 

16 - Unused 



1d1- j2U 








tandard' oer /canita dollar values for each 
budget expenditure item, Analo^.ous to 
OPVEC. Zero if does not apply. 


File 4, 


Record ilU 








Words 


Elements 


Type 


Name 




1 to 

l-lo 


1-9 


1} 

K 




Tnfril (^pnpral Fund Revenue 


19-36 


10-18 




SURPL(9) 


J>iirplus (or deficit) for each jurisdict Lon . 


37-54 


19-27 


R 


GENFT(9) 


General Fund Property Tax revenue. 


55-64 


28-32 


R 


■0THAG(5) 


Revenue from other agencies, in dollars.- 
For county is services revenue. 


65-74 


33-37 


R 


P0TH(5) 


Percent change in other agency rPivenue 
each cycle. 


75-84 


38-42 


R 


FFLRVCl., 


Dollar revenue from licenses, fees and fines 


85-94 . 


43-47„ 


R_ 


■,i,.PLFF(5) 


Percent change in license, fee and fine 
revenue. ^ 


95-104 


48-52 


R 


0NTR(5)- 


Dollar revenue from other non-tax sources- 


105-114 


53-57 


R 


P0NT(5) 


Percent charge in other non--tax revenue. 


115-134 


58-67 


R 


SPGRT(5,2) 


Special grant revenue. 

1,2:^ Capital project fund grants 
i, 1 = General fund grants 


135-136 


68 


R 


RCREV ■ 


Read commission revenue for county. 


137-138 


69 . 


R 


FRCV * 


Percent charge in road commission revenue. 
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Words Elements Type 
139-156 70-78 K 



157-174 79-87 

175-176 S 
177-320 



R 



R 



Name 
TG0PY(9> 

SmiPL(9) 

DRINT 



Total payments made on General Obliga- 
tion bonds current cycle. 

Surplus in debt retirement Tuad after nil 
bond payments. ^ 

Interest paid on debt retirement surplus, 

292 bytes unused. 



Records 5 and 6 (640 vjords) contain a r cord of Government (politicians') 
bonds a xd special millages which are in effect. Each bond or mill age re'quiref? 
a 10 word block, the contents of which are described below. Since the h) word 
blocks contain four integer variables and three real variables, the b-fO word 
array is dimensioned twice and equivalenced as follows: , 
DIMENSION KSMR (10, 64) SMR (5, 64) ' 
EQUIVALENCE (KSMR (1) , SMR (1)) > 4 

Within this array new !i'>vids oi millages are addad to the bottom of the ^ 
list; and. each cycle, as bonds or millages expire, the tabl,e is packedT^so that 
the Oldest (first added) are always at the top of the list. 

The 10 elements of each dtiboription block are as follows: 



(<SMR(1,I) 



MR(2,I) 



KSMR(3',I) 



Jurisdiction; municipalities are 1-4* County is 
5. Schools 6-9. 

Bond or millage number. 

Must be a three-digit integer starting with the 
cycle nuTTib.er times 100. For example, 301, 302, etc. 
for cycle 3. 

Type (ISPEC) code: 

1. General Obligation bond 

2. Revenue bond 

3. Special Operating millage 
A. Debt Retirement millage 



7 



KSIIR(A,I) 



ERIC 




Years « to run. 

Dollar amount of bond first year, unpaid balance 
after -that. 

Interest rate (as, for exmple, 6.255 for bonds 
or niimb^r of mills. 
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SMK(5,1) - Minimuin payiueiU. iliw^ on hoiul m'Xt rvrlr (» ,ilru- 

'iatcd in ouLpiiL link ami carrMHl (o lu'xi i-y«- NO 
or temporary sLoragc^ of bond over or undor pav- 
ment (cfalculntcul in IJDMIJ. and saved here* until 
output link) • 

M.E.T.R.Q.-APEX File //6 

This file contains the details of up to 120 c apital plant projects and ^0 
special programs defined for M.E,T,R,0,-APEX politicians. The FILEPRNT utility 
program may be used to ai\d projects or programs to the filej using a MAKE 6 
".ontrol card. Th£» first 120 records are capital plant projects and records *^ 
■j1-I60 are special prograigs. 

i 

Each 72 byte' record (36 ."wovdi;")— one projt^^ct — Ls made up in Lhe folicwinf: 
lu <ner for capita] proje*.:t:s: f 

Word . Type Nam e - <r> - 

1 I T'OC Physical location, scale and restriction of pro- 

ject. Most projects vv'ill not be restricted, 
but' a few which are expansion of existing facil- 
ities,^ may be restricted to a specific analysis 
area (there will be no ward or jurisdiction re- 
strictions). Values 1-29 indicate* locatioii re- 
. — stricted to the corresponding AA, 

30 - May be located in any analysis area. 

31 - Must be located in an entire ward, 

; 32 - Must be located in ah entire juris- 

diction. 

2 I ITYPE Budget category 

1 - Streets 

2 - Sewers 
3,- Water 

4 - Parks and recreation 

5 - Miscellaneous^ 



IMPACT. CPI' Impact of. the project 



0 - Analysis- area 

1 - Ward 

2 - Jurisdiction 
3, - County 



Note^ Player input will be by jurisdictr..ja (Pols 1-4, County = 5). 
If location of project (item //I) not in player's j urisdiction, then 
the cost — impact on CPI — will apply to. that player's jurisdiction, 
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Word 
5 



Type 



Name 



not Lo the jurisdiction wlicro located. 



7-8 
9-10 
11-12 
13-36 



R 
R 
R 
I 



NYKH Years required to construct projn'l. < 

NBOND 0 - May not be financed by revenue bond. 

1 - May be financed by revenue bond. 

NISS Issue number which will be printed in newspaper 

when planner recommends the project. (currently unused) 

ACRES Acres required, if any. 

CMIN Minimum cost (total). 

CMAX Maximum cost (total). 

KTITL (2A>- A5 character project title (last three bytes of 
array not used) . 



Each 36 word record for Special Programs is formatted as follows; 
Word Type Name ' 



LOC 



2 
3 
4 
5 



NYRS 
NCPRJ 



NISS 



Same as preceding records, except 33 = County- 
wide program. 

Not used. 

Not used. 

Number of years program is to run. 

Capital plant project also required, if any. 
To be started at minimum cost. 

Cost of each program is jurisdiction-wide. 

Related issue to be printed when program has one 
year to go. 



7-8 Not used. 

9-10 R CMIN Cost per year. 

11-12 Not used. 

13-36 I KTITLE (24) 48 character description of. program. 

M.E.T.R.O.-APEX Files'^ 7, 37 and 47 

. These files contain records of capital plant projects in effect, recom- 
mended by planners or not carried by politicians. 
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The first record of each file Is a record of polldlclans (government) pro- 
jects and the second contains those projects and programs recommended by the 
planne rs during the current cycle for inclusion by the politicians' next cycle. 
'^^^ third record Is discussed on a followAg page. , • 

The array name usually used for the first sector Is KAPLT (5; 63) and for 
the second KPLAN (5, 63). The first five words of each of the first tv/o re- 
cords are reserved for counters, etc., of the projects actually stored. Kach 
project record consists of a five word sequence; that* Is, words 6y 7, 8> 9 and 
10 of-each sector are a record of a project; words 11, 12, 13, 14 and 15 are 
the record of another project, and so on. Only words 6-320 of each record are 
used for project records. 

The five words In each project record are defined as follows: 
Word Example " - 



KAPLT (1, I) 
or 

KPLAN (I, I) 



'LT I) 
or 

'LAN (2, I) 

KAPLT (3, I) 
or 

KPLAN (3, I) 



This word Is set non-negative when a project is added 
to a list. It is equal to the associated bond number 
If It is tied to a bond or to ^ero If not (all plan- 
ners' recommendations, of course, carry a zero code). 
The years the project is to run (4th word) is decre- 
mented by one in the output subroutine and, if the 
years remaining is zero, this first word is set 
equal to -1. (For planners' reconunendations , record 
2, this word is set to -1 in CPI if a recommendation 
matches a politician's input.) Politicians project 
lists are "packed" at the beginning of CPI each cycle 
to move all multiyear projects, i.e., projects for 
which the first word is non-negative, to the head of 
the list before any new projects are added. 

Project number * 10 + CPI Impact 



Location of project * 100 + Jurisdiction inputting (to 
force county projects to print in county budget). 
Location code is as .follows: 

1-29 - specific analysis area 

30 - Ward 1 

31 - Ward 2 

32 - Ward 3 

33 - Ward 4 
,34 - Ward 5 
35 - Ward 6 
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Word Kx'ampJe 

36 - .lurLsdlct Ion .1 

37 - lurlsdlct ion 2 

38 - Jurisdiction 3 

39 - Jurisdiction 4 

40 - County 

4 KAPLT (A, I) Years project Is to run, if nev. Years remaining 

or after the first year of a multivear project. 

KPLAN (4, I) 

5 KAPLT (5, I) Cost per year in thousands of dollars. In other v/ords, 

or a project cost of $325,000 would be stored as the in- 

KPLAN (5, I) teger ' 325; If, due to division, a cost is not an even 

1000, it is rounded'u£ to even 1000s. 

The first five words of each record are used as follows: 

1 NCP Count of the number of projects ii the list In the 

corresponding record at any time. 

2 Unused. 

3-4 PJCST Total dollar value of the projects in effect in the 

list. 

5 . Unused. 

The third record of each of these files is used for two purposes: 

• ♦ ■ 

(1) A record of special programs in effect. 

(2) A record of those projects and programs recommended by the planners 
the preceding cycle but not put into effect by the politicians. 

Unlike the first two records, the third record is divided into four word sub- 
records (since cost is not needed) . 



The 


first 


four words 


of the third record are: 


1 


I 


NSP 


Number of special programs in the first list. 


2 


I 


NOP 


Number of project records in the second list. 


3-4 


R 


PGCST 


Total dollar cost of special programs. 




Words 5-164 are 


array KPROG (4, 40). The use of the first four words is 


the 


same 


for each special program as the first four words of each project de- 



scriptor in sector 1. The first word may be the number of a special operating 
millagb. 

Wdrds 165-320 are array KNOPR (4, 39). Only the first three words ard 
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pertinent and are as tlcscrlbod for records 1 and 2. 
M,E,T,R,0,-APEX Ftle. 8, 38, 48 

l*his is a file of two 640 byte records used by the plami(;r's uuLpul; link 
during a cycle. The social indicators — unemployment, low income families, 
non-white population, deteriorating buildings, etc. — are calculated and ranked 
for all 29 analysis areas. Note that the total 908 byte logical record spans 
two physical records. 



Words 
1-29 
30-58 
59-87 

88-116 

117-145 

146-174 

175-232 
233-290 

291-348 
349-406 
407-454 



Tx£e 
I 
I 
I 



R 
R 

R 
R 
R 



Name 

KP0PL(29) 
NUNEM(29) 
RNKEM(29) 

RNKL0(29) 

RDETR(29) 

W]KNW(29) 

PUNEM(29) 
PLOIN(29) 

DETER(29) 
PN0NW(29) 
HP (6, 4) 



Total population, number of persons^ 
Number of unemployed. 

Unemployment rank — largest percent unemploy- 
ment ranked as //I. 

Rank trom I (highest) to 29 (lowest) percent 
in low Income families. 

Rank from 1 (highest) to 29 (lowest) percent 
deterioration. 

Rank from 1 (highest) to 29 (lowest) percent 
non-white. *<v 

Percent unemployed. 

Percent of families with income below $.'3000/ 
year. (Household type 5) 

Percent deteriorating residential structun^s. 

Percent non-white population. 

Percent of people in each of the six wards 
perferring each of 4 fuel types — used by.AJR 
model. 



M.E.T.R.O.-APEX File 11 



This file is used to store "STUFFed'' records of input decisions and special 
output calculations. ^^^^ 

Each "STUFF" is a record 16 words long which may contain a combination of 
real and integer elements depending on the type of STUFF. Therefore, each 320 
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word physical record can SLur^^ ♦ip to 20 STUFF records. Since tlie file conLnfn> 
50 physical records a total of 1000 STUFFS can be made each cycle. 

The entire STUFF and search mechanism. Including type codes, will coviT- 
ed in a separate report. 
M.E.T.R.O.-APEX File 12 

This is a single 320 word file used for temporary or working storaj^c- be- 
tween subroutines at several different points in th'j program. 

It should not be used for other purposes between the poiflts listed unless 
care is taken to read and restore the number of words indicated at the beginning 
of the record. 

Many of these variables are retained in named COMON block /FILE12/ during 
the main section of the program. 

A* In the READA subroutine the following arrays are accumulated as BS, R^l 
and AC cards are input — a total of 72 words — and saved until after thr 
caJculation of voter turnout In iRNOT. 

Words Name 

I- 10 TTNSM(5)'^^ Total non-school mlllage 

II- 18 TTSCM(4) 'lotal school millage 

19-28 TTNED(5) Total non-school dollars in bond proposals 

, 29-36 TTSCD(4) Total school bond proposals — dollars 

« 

37-54 RMTlCY(9) Requested millage rate, current year 

55-62 RAF(4) .New assessment factors, if any 

63-72 SCAMP(5) Sum of campaign contributions, by jurisdiction. 

B. Savpd dr.ring TOMM model. 

73-246 ERRM(29,3) - Endogenous employment prior to growth. 

Saved during TOMf^ for comparisons at end. 

C. Saved from the end of BDMIL to CPI: 
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73-111 NW0RK(3y) - Numbers of bonds aiul/or millagos pass(Mi m !;i)MII.. 
112 NPASS - The number of useful elements stonul in iWiMIk 
D. Newspaper Flags 

Word 121 - Bits set to indicate low per capita budget items lor 
central city. 

Word 122 - Bits set to indicate low per capita budget items for county. 
M..E.T.R.Q.-APEX File 15 

Arrays carried from main program to newspaper section. 
Name 

Q4PDL (8) Total campaign dollars for each of 8 politicians 

OPDOL (8) Total campaign dollars opposed to 8 pol i ti«^^:inns . 

DOL (20) Campaign expenditures (algebraic sum) for each 

of 20 bond or millage proposals. 

NBS Number of bond or millage proposals this ryclel 

LBS (20) Numbers^ of proposals. 

filler 

ft 

PROMO (5) Total promotional dollars for each of 5 juris- 
dictions. 

PCSTD (5) For CEM - Numbers of voters by ward. 

ISFLG (20) Numbers of issues to be printed in newspaper 
when special program has only one year to go. 
Stored as (issue + 1000 x jurisdiction;. 

M.E.T.R.O.-APEX Files 16, 36 and 46 

These .are key files in M.E.T.R.O.-APEX. ' 

Only the first 3 records of the eight possible records are currently beinji; 
used. The first represents the first 40 words of blank COMON storage. Since 
these words contain some pointers and indicators for STUFF and for searching 
the STUFFed file (11) as well as other common information, they must be carefully 
saved and restored if this upper common area is ever to be used for other pur- 
poses, and must also be saved at various points for restarts. 



Words Type 

1-15 R 

17-32 R 

33-72 R 

73 ^ I 

74-93 1 

94. 

95-104 I 

105-114 R 

145-164 t 



97 



The use of the forty words is as follows: 
Word Type Name 



2-4 



7-10 I' 
11-22 ^ R 



23 

24 
25 

26-29 

30 
31 

32 
33 



NCYCL 



.KDATE(3) 



LDP 



LIIAND 



MIN(4) 
ZIN(6) 



PACK I 

\ PACK2 

IXPRK 

INFO (4) 

LPKl 
V LPK2 

KC44 
^ IROLE 



Cycle number. Set to 0 in file 36. Incromenlcil 
by^^l^Jn core if going on to new cycle, but cycle 
number not incremented in the file until end of 
successful execution. 

Date of run. Set in MAIN for use by EJECT in 

output links. First word is month, second is 
day, third is year. 

The first seven bits (0-6) are set by ISET to 
indicate those realtors playing in the CYCLE. 
Bits 7-13 are set for playing industrialists. 

Initial 5 digit random number initial value. Set 
to 24683 for cycle 1. Thereafter it is the./'old'' 
value plus the sum of the 3 elements of KDATE 
and adjusted to be odd number. 

These sixteen words are used for STUFFing and 
searching. The first four words, are always 
integer ♦ 2, sometimes referred to_as the first 
four elements of MIN(16) bu^also referred to 
by specific names in some* links. The next 
twelve words may be either integer * 2 or. real 
* 4, depending on the STUFF record. They are 
usually referred to as ZIN(6). MIN and ZIN arc 
equivalenced as follows: 

EQUIVALENCE (MIN(5), ZIN(l) ) 
Other specific variable names are frequently equi- 
valenced to specific elements of MIN or ZIN. See 
STUFF description for more details. 

The number indicating which of the 20 sixteen 
x7ord STUFF records in a physical record was the 
least one STUFFed. ^ 

l^mich sector of the 50 in file 11 was last STUFFed 

Index of **found" STUFF from subroutine QERCH. 

See comments in QERCH. 

QERCH analogues of PACKl and PACK2. 



Player number (developer, industrialist, politi- 
cian, etc.). Used by EJECT for page headings. 

Flag for EJECT to indicate output heading. 

1 - Realtor 

2 - Politician 
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Word 



T2£e 



Name 



34 



35 



36 



37 ^ r- ] 

38 ] 
39-40 
Record //2 
Word 



1-28 

29-40 
Record #3 
Word 



R 



R 



IFUSE 



NPAGli: 



LSW 



NOIO 



NTEAM 



Name 



CASH(14) 



Name 



3 - Educators 

4 - General Summary 

5 - APCO 

6 - Industrialist 

7 - Planruers 

Flag set in output subroutines, primarily mis- 
cellaneous output, to decide if number of Jines 
printed requires skipping to the top of a new 
page. Used only in output links. 

Used by EJECT ^ub rout Lne in output links to 
keep running page-^rrumber . 

Switch set for print suppression of individual 
players in output links by data switch set-ting. 

= 1 Print 

- 2 Don' t print 

Master print suppression flag. Set in response 
to SUPPRESS=ALL to suppress all printing. 

Team number. .1 

Temporary use in LAND section of program. 



Running cash balance in account of each of tlio 
realtors (1-7) and industrialists (8-14). 

Mot used at present. 



1-20 R .TNAME(IO) Team name, EBCDIC 10A4. 

21-40 Unused. 
M.E.T.R.O.-APEX Files 19, 39 and 49 

These files contain capital plant values, indices, ranks, population equi- 
valents. One logical record of 1888 bytes spans three physical records of 640 
bytes. . ' , 

The following is a summary of the file 19 contents; a detailed variable de- 
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•scription follows tlie summary: 



Consecutive 
l/ords 


Variable 
Type 


Name and Dimens i oiis 


Phys i oal 
Record 
Number 


I'liys i c.i 1 
RufortI 
Word 


\\ 1 emt'iits 


1-648 


R 


CPTOT (36, 9) 










Tlie 9 


columns of tlie above array are as 


follows : 




1-72 


R 


Col. (1) Streets: 
CPTOT (1.1) to 
CPTOT (36, 1) 


1 


1-72 


1-36 


73-144 


R. 


Col. f2") Sewer <? 


1 

* 


73-144 


37 72 


145-216 


R 


Col. (3) Water 


1 


145-216 


73-108 


217-288 


R 


Col. (4) Parks/ 
Recreation 


1 


217-288 


109-144 


289-360 


R 


Col. (5) Miscellaneous 


1"^ 
2 


289-320 
1-40 


145-160 
1-20 


361-432 


R 


Pnl ((\\ Tn^^^ Pn\/or-n— 
V^UJ.. i- U LO J. , V U 1 II 

ment (sum of first 

D LUJ.unillo . ) 


0 

c 


41-112 


21-56 


433-504 


R 


LiOi. ^/^ local hJ.c~ 
mentary School 


9 


113-184 


57-92 


505-576 


R 

.1 


Col. (8) Total High 
ocnooi 


2 


185-256 


93-128 


577-648 


R 


Col. (9) Total School 
(sum of 7 & 8) 


2 
3 


257-320 
1-8 


129-160 
1-4 


649-792 


R 


CPI(36, 2) 


3 


9-152 


5-76 


793-864 


R • 


POPEQ(36) 


3 


153-224 


77-112 


86 5-866 


R 


CONVF 


3 




11"^ 


667-938 


I 


KPRNK(36, 1) 


3 


111-1^^ 


111-1^% 


939-940 


R ' . '7 


COCPT 


3 






941-942 


R 


COCPI 


3 


\ 




943-944 


R 


COPOP 


3 






945-960 


Unused 


at present. 









100 



Variable Descriptions for Files 19, 39 and 4 9 
CPTOT (36, 9) 



CONV 

POPEQ (i) = 
cri (36, 2) 



KPRNK (36, 2) 



COCPT 



Total capital plant value in each of 9 (:atc:j;i)rios 
(see below) for each of 3r) goographii: areas. 1 iV 
actual practice 'the pro^^ram aiUIs cost per year from 
file 6. as each' project Is pro^cessed In SUBROUT t NM 
CPADD. Once a project is^^ completed no appreciat ion 
or depreciation on value takes place. 

Thei first 29 rows Correspond to tlie 29 APEX . analys i s 



areas. 








Row' 


30 


Ward 1 




Tor,al 


Row 


31 


Ward 2 . 




Total 


Row 


32 


Ward 3 




Total 


Row 


'33 


Ward 4 or 










Jurisdiction 


2 


' Total 


Row 


34. 


^Ward 5 or 










Jurisdiction 


3 


Total 


Row 


35 


Ward 6 or 










Jurisdictipn 


4 


Total 


Raw 


36 


Jurisdic tibn 


1, 








.Central City 




Total 



Conversion fa.ctpr for converting number of employees 
to pppuJ.ation equivaJents, POPEQ. It is p'rosentiv 
(3-31-7 ) equal to 1.25. Population equivaUmts ^ 
are calculated as: 

Total'" Employees in all categories / CONVF 

Capital Plant indices for each of the 36 areas do- 
scribed above. Column one is government (politi- 
cians) and is column 6 of, CPTOT/POPEQ. Column two 
is element ary s ch o q 1 capital plant index: 

^ CPI (1,2) = CPTOT ( 1, 7) 

Number of elementary pupils 

The rank of -the .corresponding capital plant indices— 
the largest value is ranked 1. 

Total dollar value of count:y capital plant (mis- 
cellaneous) . 



COCPI Coun'cy capital plant index. 

COPOP County population equivalents. 

M.E.T.R.Q.-APEX Files 20 (30 and AO) ' " 

This seventeen record file contains records of the seven game realtors' 
and seven industrialists loans and taxes as well as other arrays and constants. 



^^necessary in subroutine TAJCLN for loan and tax processing. 



ERLC 
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Each of the first 14 rc^cords in' these file« :\ro only >80 hytos lonj^ and 
contain variables pertaining to one of the game realtors (records i-7) or in- 
dustrialists (records 8-14). The vari ables in each of the records are as 
follows: 

Description 

Cash balance at end of preceding cycle for the player. 



VJord Type Name 



1-2 

5-6 
7-16 



32 

33-34 
35-36 

37-38 
39-40 



R 

R 
R 



17-26 R 



2 7-31 



R 
R 

R 
R 



OLDCll 
PROPV 

TTXPD 
TAX(5) 



TDELT(5) 



DELTX(5) 



LSF 

TLDBT 
TNEWL 

TLPAY 
FLLMT 



Total property value for the p layer at^.^end of pr- - 
ceding o^cJe. 

Total taxes paid current cycle for the player. 

Taxes for the player for each jurisdiction coraputcd. 
at end of preceding cycle or; total unpaid delinquent 
taxes during current cyle after payments are pro- 
cessed. 

Total delinqu^vat taxes paid during current cycle in 
each jurl.<?dLCtion by the player due to land con- 
fiscatloiK 

■iJountors of number of times taxes wore not paid in 
full for, the player, in each of the 5 jurLsdiclicins. 
If unpaid for two consecutive cycles, land is con- 
fiscated for the payment. 

Financial standing of the player from 1 (highest) 
to 3 (lovrest). Presently hase„d only on loan under- 
payment^. ' L. 

Total outstanding loan balance for player. 

<Total dollar value of new loans current cycle for 
the player. 

Total loan payments made current cycle by the player. 

Loan limit factor for the player — the proportion of 
his net worth which he can borrow. 



The 15th record of these files is 128 bytes long and contains variables 
not specific to any one player but which are used fo^r calculations relating to 
all players: 

Word Type Name ^ Description " 

1 I NJ Count of number of loans in the loan table — which 
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VJotd Type NaniG 



I NIC XT . 



3-14 I IRATE (4, 3) 



Description 

k — — «• 

follows — or pointer to last used 10 word bJcntk. 

Tlie last loan number assLj^noil. This i«, i.n elTort, 
a count of the total number of loanvS' procos.senl 
during a game since loan numbers are not re-used 
once a loan is paid off,. It does not necessarily 
represent the niimber of loans in the table • 

r 

Interest rates at which new loans are granted. 
The four rows are differences due to life (length) 
of the loan: 

IRATE (1,1) - 1 or 2 years 
^ IRATE (2, I) - 3 to 5 years 

IRATE (3,1) - 6 to 10 years 

IRATh (4,1) - over 10 years 
The three columns are for the 3 possible credit 
standings'! (LSF) . 



15- 


16 


R 


-XIHT 


Interest rate paid on cash savings for player^. 
Added at beginning of cycle to cash from precedl 
cycle. 


17- 


18 


R 


TINT 


Interest rate charged and added to unpaid taxes. 


19- 


20 


R 


PENFC 


Penalty factor against loan underpayments. 


21- 


22 


R 


REDOX 


Factor for reducing FLtllT if loan underpayment, 
i,e,, reducing loan limit. 


23-36 


T 


LUC (14) 


Loan underpayment counters^ for each player. If 
delinquent in loan payments 3 consecutive cycles 
payment is forced froni*'cash balance* 


37- 


64 


R 


TNETW(14) 


Net worth at end of cycle for each player. Used 



primarily from file 40 for comparison with current 
value. 



The 16th and 17th physical records of these files make up one logical 
record v/hich is the table of loans outstanding for the realtors. Each loan' 
requires a block of ten words (20 bytes) so that a maximum of 64 loans may be 
outstanding at any one time. (When the table becomes full during play the 
table is packed .by eliminating all loans with a zero balance.) 

The first four words of each 10 word loan record are 2 byte integers and 



the last three elements (6 words) are real *.4. For this reason the array is 
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identified by two names and equlvalenced as Tollows: 

DIMENSION XJ (5, 64) 

COriMON .1 (LO, 64) 

(•OUIVALKNCi!: (J (1), XJ (1) ) 
The elements of eacli loan record arc as follows: 
Word 



4 

5-6 

7-8 
9-10 



J(1,I) 

J(2,I) 

J(3,I) 

J(4,I) 
XJ(3,I) 

XJ(4,T) 

XJ(^ 1) 



Numbe 
the 



er <x£ the land 
lokj^ Integer 



developer or industrialist receiving 
from 1-14. 



Loan number. Assigned by the progrtim from 1-N, printed 
on the output, and used to identify loan payments. 

Interest rate. Note : this is an integer value, e.g. 
81 = 8.1%. 

Years remaining in loan life. 

Dollar amount of loan or, after the first year, the un- 
paid balance. 

Dollar penalty for underpayment. 
Minimum payment next cycle. 



M.E.T.R.O.-APEX File 21 

A single record file containing constants used in land transactions In 
LAND and SELL. All values are preset and are not initialized or saved from 
preceding cycle. 



Words 



1-10 



11-22 



IXfie 

R 

R 



Name 



UDENV(5) 



DTS(6) 



23-24 



PNF 



Spread vector used with "U" variable (see Flic 
1 description) to get increasing land use dens- 
ity. 

Proportion of total property value which is 
demolition cost when property goes fron devel- 
oped to vacant. Values for the six vacant cate- 
gories. 

Public N Facwor - a proportion of public land 
which becomes rlght-of-v/ay when public land 
is developed. 



25-26 



PDFS 



Dollar per acre cost of public land demolition. 
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Wo rds 



27-A8 



49-70 



71-72 



73-122 



123-172 R 



Nnint' 

U(:i)KV( 1 1 ) 



BVKC(ll) 



R2R2V 



HPREF(5,5) 



ZPREF(5,5) 



4 , 



prr iinil (<ir ;icn% if rojjuiHTrivil ) to rmisl nu I 
or ilrv<»lo|) properly \\\r II <lcvi* loprd i-alr- 

Raw land improvement cost (clearing, streets, 
curbing, sidewalks, etc.) for the same 11 cate- 
gories as RCDEV. May be modified by E factor 
in File 1 which is presently at 1.0. 

Proportion of multiple zoning type 2 (MDR( 5) 
family or housing units which can be displaced 
by commercial demand in SELL. Presently set 
at 10%. 

Percent of each household type (2nd subscript; 
that prefers each of^the five developed resi'ir'n- 
tlal housing types (1st subscript). Usod to 
allocate demand after TOMIl. 

Housing Type 



^.11. 

Type 


Rl 


R2 


R3 


Ml 


M2 




1 


50% 


30% 


0 


20% 


0 


100% 


2 


20% 


20% 


20% 


20% 


20% 


100% 


3 


10% 


30% 


■ 20% 


25% 


15% 


100% 


4 


0 


7.0% 


40% 


10% 


30% 


100% 


5 


0 


0 


40% 


0 


60% 


100% 



Percentage of each type of household ILvinj!; in 
each housing type. Used to allocate displaced 
households when units go from developed to 
vacant. 



Household Type 



ERIC 





»1 


"2 


»3 


«4 


»5 






62.5% 


25.0% 


12.5% 


0 


0 


100% 




30.0% 


20.0% 


30.0% 


20.0% 


0 


100% 


h 


0 


16.7% 


16.7% 


33.3% 


33.3% 


100% 


"l 


26.7% 


26.7% 


40.0% 


13.4% 


0 


100% 


"2 


0 


16.0% 


12.0% 


24.0% [48.0% 


1007. 
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Words 


Type 


Name 


- 


173-174 


R 


PLIMU 




175-176 


R 


PLIMD 


Related to orico iiil lU.stmonL for ri><^ i cU'ix i<) 1 


177-178 


R 


PA 


property. Soc fol lowinji discuss inn. 


179-180 


R 


PB 




181-182 


R 


CLIMU 




183-18A 


R 


CLIMD 


Analogous to preceding four varL.nblt»R for 


185-186 


R 


CA 


conmiercial prices. 


187-188 


R 


CB 




189-320 






Unused at present • 




1.0 

DEMAND RATIO 



Price adjustments each cycle are computed as a function of the ratio of 
demand for a particular type of property within an analysis area to the demand 
for the same type over the entire APEX area. The function generates a multi- 
plier which is applied to the corresponding price and which is calculated from 
an S-curve algorithm. In other words, if demand is greater in a specific area 
than overall a multiplier such as 1.03 or 3% increase would be used. If demand 
were lower thv. multiplier might be a 0.96 or 4% decrease. 
. Mathematically the multiplier is calculated as follows: 
If T ^ 1.0» then X = T-1 and M = S * LIMU + 1, 

If T < 1.0, then X = (T-1) and M S * LIT© -f 1. 

T 

Ifliere T = demand ratio 

M = price multiplier 



106 



III .sLiui>.k' terms, LlMll = laaxinuiin |i ropo: t i ol i lu-i'cuu' In pri4i', how iimrli 

greater tliaa 1.0 can Lho nuilLinlu'r lie. 

MMl) = maximum proportum of dc crease fn priei*, i.e., Ik^w mneli 
less than 1,0 can tlie inultHpHer Ik*, 

A " maxLiiMim sJope of M curve, wiueh clet^u'mines how rapiilly 
the multiplier Increases or decreases witii a clianp,e in 
demand ratio . . 

B = horizontal-axis intercept . It is set at 0,0 which 

causes a ratio of 1,0 to produce a multiplier of 1,0, 
If B > 0 the axis would be moved to the right, meaning 
. that it would require a demand ratio greater than 1.0 to 

keep the pric3 from going down as might be the case in 
a depression or, if B < 0 tlie axis would be moved to the 
left which would mean that a demand less than 1,0 could 
still cause an increase in price, 

M.E.T.R.O.-APEX Files 22, 32, 42 , 

Counters of families and employment. 

Record //I: 



Words Type Name 



1-145 I 
146-2 32 I 



233-319 1 
320 

Record #2 : 
Words Type 
1-58 R 

59-116 R 
117-118 R 
119-128 R 



PDM(29,5) 
NJGTC(29,3) 



JDKLT(29,3) 



Name 
EBUR(29) 

EIND(29) 

TEW 

HFCr(5) 



Number of families in each of 5 types in each AA, 

Number of employees in each of the thre endo^ent 
employment categories in each AA. Col. 1 is local 
comniercial ; Col. 2 is regional coimT:iercial ; Col. 3 
is local industrial, 

(Used only in file 22, not initialized.) Change 
in employment from TOMJt — used in SELL. 

'Unused. 



Number of exogenous bureaucratic employees in 
each analysis area. 

Exogenous industrial employees in each AA. 
Total Exogenous Employment after GROW, 
Persons per household by type. 



129-140 I 



EXBir(12) 



Same as words 54--65 of File 512. Set to zero in 
file 532. 
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M^E^T.R.O.-APEX file 28 " 

This 116 record file (four seasons times 29 analysis areas) is a spoolal 
matrix of. wind diffusion datii for the AIR modol. The details ol its lahvjia-- 
tion and use will be dealt with In a .separate; report, 
M,E,T,R,0.-APEX Files 51, 61 and 71 Process File 

Data on each industrial process for gamed and siraulat<;^.d industries. 

Note: The record number of each process is indexed in the Industry File (#58). 
That is, process x for industry I is in record number IRECD + x - 1, 
e.g. process 2 for industry 4 would be in IRECD +2-1 and if IRECD - 10, 
process 2 is in record 11 of the process file. 



Word 



1-10 



12 
13-22 
23 
24 

25-27 



28 

29-30 

31-35 
36 

37-38 
39-48 



Element 
1 5 

11 
12 

7-11 
23 
24 
25 



28 
15 

31-35 
36 

20-24 



Tj£e 
R 

1 
I 
R 
I 
I 
I 



Name 

-REMIS(5) 

RSMOK 

RODOR 

GEMIS(5) 

GSMOK 

GODOR 

ICS(3) 



R 

I 
I 



ITYPE 

RPROC 

MUNIT(5) 
IRATE 



R OPER 
PNAME(5) 



Description 

Rate of contaminant emission current 
(in Ib/hr). 

Rate of smoke emitted (Ringlemann' 5i) • 

Rate of odor emitted (Stinks). 

Potential (uncontrolled) rates. \ 

Potential Ringlemann. 

Ditto Stinklemann' s. 

Control system applicable. 

Negative: not operating, not installed 

.LT. 100: operating 

.GT. 100: installed, not operating. 

Odor type: 1 = putrid, 2 - acrid, 
3 = sulphurous, 4 - pungent. 

Process rate, in input mat. /day, 
except for fuel, quid in lb/unit output 

Name of units in RPROC. (10 characters) 

Conversion factor for RPROC. 
RPROC * IRATE = production rate in 
1000 Ib/hr. 

Operating period, as % of day. 
Process K.?.me. (20 characters) 



KIC 
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M.E.T.R.O.-APEX 


File 52* 62, 


72 - Air Pollution Laws and Al'CO data 


Word 


Type 


Name 


Description ^ 


1-10 


R 


?RI0P(5) 


\^ri.co of operation of 3 lypos v^f munUoriuj\ 
H-tnt ions. 


11- 1.2 






llnu.'^JCMl . 


13-84 


R 


PRICIi:(6,6) 


Upgvadc costs of monitoring stations: 

U J ^ U 3 


85-86 


R 


COSTI 


VjOSL or pXdltL X llo PcL. L i. Uli • 


87-88 


R 


COSTM , 


Cost of eniission TTiBasurement. 


89-100 


R 


CB(6) 


Lounty DUugec iLems. ^ 


101-102 


R 


CTOT 


Lotai LiOuntv /vj-j-ocaLiuii • 


103-108 


R 


UNl)( J; 


recierax xuna i ueins rur j yccAitD. 


109-14A 






Unufied. 


145-173 


' I 


OPMON(29) 


Monitoring stations in operation. 


174-202 


1 


MONS(29) 


Monitoring stations in existence. 


203-212 


R 


APASK(5) 


Air pollution control of fleer ' s roqucs ts for 






contaminant level used to compute the number 'of 
days above some level. 


217-2'5p6 


R 


PDSHR(5,3) 


Pounds /hour limitation on the five .pollutants-- 



(A,i) = NOx, (5,i) - HC. 
247-276 R PDSPU(5,3) ' Pound/processing unit limitation, as above. 

277-279 I 1M0KE(3) Smoke limit, Ringleman 0-5. 

280-282 I I0D0R(3) Odor limit, Stinkleman 0-5. 

283-288 R FINE(3) Fines. 

The three columns in arrays PDSHR, PDSPU, IMOKE, lODOR, and FINE are, re- 
spectively, state regulations, county regulations and recommendations to the 
state. ^ ^ 

289-302 R Affr(7) Amounts gamed industrialists have been fined. 

303-312 R C0EFF(5) Coefficients for complaint gd^ST^fator. 
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M.E,T>R.Q.-APEX File 53 — Control Systems 

This file holds the percentages for reducing emission rates due to 



installation of the named system. 



Word 


0 

Type 


Name 


Dosor ip t: ion 


1-10 


R 


PCT(5) 


Pc recti L ro duct ton In nun ss ions - p.i rL i i-it 1 .i Los , 

S*f) CO MO \\C 
2 X 


11-12 


I 


LSM0D(2) 


Reduction in smoke and odor. 


13-14 


R 


ORIGD 




15-16 


R 


OPERD 




17-40 


I 


NAME (24) 


HO ei Ld Lcic. L c L v^uiiLiruj. oyoLciu 11 dine • 


M.E.T.R.O.-APEX Files 54, 64 


anH 7 A r^smoH "inHiicf"T"'ioc f^sit'^ 


The 


Industry 


number is 


the record number. 


Words 


Type 


Name 




1-3 


I 


NEMP(3) 




4 


I 


lAA 




5-6 


R 


TEQBG 


Total value Equipment, Building and Air Poilu- 
t'lnn Fniiinmpnt . 


7 


I 


lOP 


1 if AVflil ah 1 p f nf n lav . 

0 if not available for play (no data). 


8 


I 


MFUEL 




9-10 


R 


CINCP 


(Units/$). 


11-12 


R 


CPMIN 


Minimum expenditure on equipment* 




R 


. CINCB 


Potential capacity increase due to building in- 
crease ^unxus/scj* ll*^* 


15-16 


R 


BIN VII 


riimmum Duu.umg mvebLuieriL. xiierciueiiL cij.j.uwc3U±< 


17-18 


R 


CLAND 


ijuiJ.aing capaciuy cnange aue i^o xana increase 
^q. ft./ sq. ft.). 


19-20 


R 


SINCE 


Increment in sq. ft. building/$ expenditure on 
building. 


21-22 


R 


EMPDR 


Employment/Production ratio (employees/unit) . 


23-32 


I 


IPCTS(IO) 


% changes in sales standard MKTSL. 


33-42 


I 


IPCTC(IO) 


% changes in PRMKT 



ERIC 
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Words 


Type 


Name 




43-52 


I 


IPCTC(IO) 


Z chnngt^s In prcnhifL-t-osi s . 


53-54 


R 




Maxinuim c*.apai:iLy ol l i rm nrxl. rycU*. 


55-60 


R- 


NPL(3) 


ProducLion I.cvc I . 


61-66 


R 


.NESTS (3) 


Estimated sales (unit). 


dl-ll 


R 


NACTS(3) ' 


Actual sales (unit). 

> 


73-78 


R 


PRICE(3) 


Price set by indqs.trialist. ($) 


79-84 


R 


PRMKT(3) 


Market price. ($) 


85-90 


R 


ESTS(3) 


Estimated sales. ($) 

Actual sales. ($) ' 


91-96 


R 


ACTS (3) 


97-102 


R 


INSLD(3) 


Inventory sold (units). 


103-108 


R 


IVNT(3) 


Inventory last 3 cycles (units). * 


109-110 


R 


ICOVR 


Inventory carry over (units). 


111-119 

J. J. X J. J. ^ 


IS. 




« 1- ^ 


jL X J~ J. X ^ 


15 
1\ 






117 lie 


K 


^^Ul V IN 


i 0 cax invent 0 ry car ry mg cos l . 


1 1 Q_ 1 on 


K 


UrlJN V 


uurrenc mves Linen l in eqiiipinenL vnon puxxuLxuii/ 


121-122 


R 


CPLIM 


Equipment investment limit (maximum)* (.$) 


123-124~ 


R 


BINVE 


Current investment building. ($) 


125-126 


R 


BDLIM 


Building investment limit. ($) 


10 7 1 0 Q 
1^ /~ XZO 


K 




ueprecxacion expenuiLULc \^u(=Lcrxuj.ciuj.uii/ . 




K 




oq. rC. 01 Duiiamg. 


X OX— X J J 


T 




/o capaci ty usee . 


1 Q/. T 


T 


TO IJT> 


Flag = 1 to indicate purchase of control system 
data this cycle. 


135-136 


R 


TLC 


Total labor cost. 


137-138 


R 


TMC - 


Total material cost. 


39-^140 


R 


TFC 


Total fuel cost. 



ERIC 



1 1.1 



Words 


Type 






141-142 




TAG 


Total" administrative cost. 


143-144 




TPCO? 


Total pollution control operating expenses pai< 


145-146 


R 


APFPD 


Air pollution fines paid. ^ 


147-148 


R 


EMT-IEX 


Emission measurement expenditure thi^ cycle. 


149-150 


R 


CAMEX 


Campaign contributions. 


151-152 


R 


DPAL 


Depreciation allowance marJe. 


153-154 


R 


PROG 


Gross profits. * 


155-156 


R 


FEDS 


Federal-state taxes . 


157-158 


R 


PRON 


Net profit. 


159-160 


R 


CEXEQ 


Capital expenditure on equipment (non-pollu- 
tion) . 


161-162 


R 


CEXLD 


Capital expenditure on land. 


163-164 


R 


CEXBG 


Capital expenditure on building. 


165-166 


R 


CEXAP 


Capital expenditure on air pollution. 


167-178 


R 


CFUEL(6) 


Unit cost of each of six fuels. ($/unLt) 


179-180 


R 


TLPAY- 


Total loan payments. 


181-182 
183-188 


R 

I 


TTXPD 

IFUEL.(6) 


Total tax payments (local) . 

Fuels available for use (1 = available, 0 = noi 



available) .The six fuels, are; Low grade coal, high 
grade coal,lowgrade oil, high grade oil, natural gas 



189- 


•190 


R 


UNIT 


Name df product unit. 


191- 


■192 


R 


TAPCV 


Total air pollution control value 


103- 


■194 


R I 


DVLPD 


Acres developed land. 


195- 


■196 


R 


VACNT 


Acres vacant land. 


197- 


198 


R 


MKTSL 


I-larket sales standard. 


199- 


■204 


R 


MAXC(3) 


Capacity last 3 cycles. 


2057 


206 


R 


UICC 


Unit inventory carrying cost. 


207 




I 


NPROC 


Number of subprocesses. 


"08- 


■222 


I 


NA>IE(15) 


Industry name (30 characters). 



ERIC 



112 



Words " 


5Z££ 


Name 




223-223 


R 


TOTC 


Total cost of production. 


225-226 




- TCASII 


Total, cash availoblc. 


in~iiz 








229-230 


R 


AVAL 


Total land value. 

• 


231-232 


R 


ALLOW 


Maximum depreciation allowance for next cycle. 


233-240 






Unused. 


M.E.T.R.O.-APEX 


File 58,68,78 


- Record of all industries, gamed and simulated 


it 

Note: The record number corresponds to the Industry number. 


Words 


Type 


Name 


Description 


1 


1 


ICP 


Operational Status of Industry - 


2 


I 


lAA 


Analysis Area. 


3-4 


R 


RPROD 


Outpu?: of Finn. 


5-6 


R 


PRODG 


Production Capacity of Firm. 


7 ■ 


R 


IRECD 


Record number in file 51 of the first process 
for gamed industries. Except for the gray iron 
foundry, (Ind. 3) IRECD is the fuel process. 
For sir.ulated. industries, it is the only pro== 
cess. 


8 


I 


NPROC 


Number of production processes used by the Firm. 
For simulated industries, NPROC = 0. 


9-13 


I 


NUNIT(5) 


Name of appropriate production unit per unit of 
time. 


14-28 


I 


FNAME(15) 

1 ■ 


Firm name — 30 characters. 
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M.E/r.R.Q.-APEX File 204 ' 

This file consists of ten 64-byte records, whore each record corresponds 
to a cycle of the game. Each record is identical. 
Words Type Name . Description 

1-32 I ISSUT(32) Each non-zero value is the number of a "record" 

in file 201. These are the preset issues for 
the cycle represented by the record number. A 
listing of these preset issue numbers may be 
obtained by running FILEPRNT and specifying PRINT 
204. 

M.E.T.R.Q.-APEX File 205 

This file consists of ten 12-byte records. Each record corresponds to 
a cycle of the game from i to 10. 

Words Type Name Description 

1-6 I IEX0(6) The numbers of from 1 to 6 exo firms which are 

preset to desire entry into the community the 
following cycle. Used only by the newspaper 
printing section of the program. 

M.E.T.R.Q.-APEX File 206 

This file consists of ten 40-byte records, where each record corresponds 
to a cycle of the game. Each record is identical and consists of a set of 
from 1 to 20 preset state and national headlines. Since the one vector con- 
tains both national and state headlines and since they may be a combination of 
singlerline heads and multipe-line heads the following scheme is used to 
identify the values in the file: 

1. The first values in each record are national headlines. As the 

program interprets each record from left to right the first state headline 
is identified by being a negative value. All values following the 
negative number are state headlines. 'A zero value terminated the list. 

2. Values less than 1000 are record numbers in the issue file (file 201). 
All values greater than 1000 are record numbers in the headline file 
(file 203) to which 1000 have been added. 
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M.E.T.R,Q,"APEX File 209 (also referred to as file 5 in some iusLaiu:os) ' ' 

This file contains descriptions of all of the preset exogenous induslrii's 

which are programmed to wish to locate in the MUTAPKX area during the game. Duly 

45 of the 48 records are initially used allowing room for expansion of the^ file. 
Each cxofirm record consists of the following data: 

Words Type Item- 



1^, 



1-16 I 

17-20 r 

21 I. 

22 I 

23 I 

24 I 
25-26 I 
27-28 R 
29-30 R 
31-32 R 
33-34 R 
35 I 



NAME (16) 

IPREF(A) 

NEMP 
IZONP 

NISSU 

NYRS 

RATE 



A^f^ 



ACRES 



TAX 



COST 



IBIT 



ERIC; 



Name of the exofirm. Up to 32 characters, 2 . 
characters per word (16As). 

Analysis area in which the fi::m wishing to locate 
in order of preference. May be one to three given, 
fourth is unused. 
Number of employees. 

Coded to indicate the land use type which needed 
to be rezoned industrial. Now unused since the 
restriction has been abandoned. 

Number of issue generated if the firm enters the 
city. 

Years over which the realtors receive a return 
on their Investment. 

Rate of return on realtors investments, stored 
as 1.05 equiv. to 5%. 

Amount of realtor investment required in order 
for an exofirm to enter. 

Numbers of acres of I2 land needed for this 
exofirm. 

Dollar addition to the tax base in the analysis 
area in which the firm locates. 

Cost of capital plant additions (sewer, streets) 
required for entry of this exofirm. 

Word containing bits set to indicate conditions. 
These bits are tested by function ITEST: 
Bit 0 - 1 if Industrial 

0 if Office (bureaucratic) 
Bit 1 - On (=1) if firm should be forced 
in even though all politicians 
and/or realtors conditions are 
not met. 

On if rezoning required.^ 
On if new sewers required. 
On if street improvements required. 



Bit 2 - 
Bit 3 - 
Bit 4 - 
Bit 5-15 - Unused. 



INDEF 



If non-zero, number of industry in tfile 58 which must 
be activated if firm enters. Will be 0 if no industry 
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' ERIC 



M.E.T.R.O.-APEX Files 511. 531. and 541 

This single record file contains vectors of preset growth percentages for 
various sectors of that local economy for ten cycles plus records of national 
and local employment and unemployment. (In the 1130 version of the program it 
was a single file included at> part of file 3. It was made a separate file be- 
cause it may vary from team to team.) 

Words lillements Type Name Description 

I- 10 • 1-5 R UNEMP(5) Local unemployment for each of the 

five household types in current cycle. 
Calculated from UNAPX(t+l). 

II- 32 6-16 R UNAPX(ll) APEX area unemployment rate. The sxih- 

script is cycle number +1. The first 
value is starting value for cycle 0, 
the second value calculated for cycle 
1, etc. 

33-34* 17 / R STPPA The starting, cycle 0, student popula- 

tion of the university presently set 
at 27,000. 

35-54 18-27 R STPOP(IO) A record of the new student population 

for each cycle. The value for the 
current cycle is printed in the output 
for Politician 2. 

55-74 28-37 K PCTNK(IO) Percent Change in Total Matlonnl Kmplov- 

mont . 

75-94 38-47 R PEXTC(IO) Percent Chanp,c« Ln-^l-Xogenaus employmc^nt 

in APEX This Cycle, both bureaucratic 
and industrial, for 10 cycles. This 
change including addition of exo firms 
and*Bamed industrial growth after na- 
tional growth rate applied. 

95-114 48-57 R GOVTG(IO) The present growth proportion of exogen- 

ous bureaucratic employment (EBUR) in 
AA 8 (state government) for 10 cycles. 
A 3% growth would be stored in this ar- 
ray as 1.03. 

115-134 58-67 R UNIVG(IO) The growth proportion of university en- 

rollment by cycle. 

135-154 68-77 R CUSLF(IO) Percent change in total US labor force. 

55-174 78-87' R CAPLF(IO) Percent change in labor force in APKX 

area. : 
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M.E.T.R.O.-APEX Files S12. 532 and 542 

These files cont.iiii records of which exoJ"! riiis ;iri' jsresel to i-nli-r in ii|> 
to 10 «-yrles, which exollniis iliti .-iikJ iIIiI not ciiler .ind dHut iiilijrm.it ittii pt-r- 
talning to exofirms for ne\»spaper printing'. 
Words Type Name Descrtp'ttoii 



1-40 



41 



42-47 



48-53 



54-57 



58-61 



62-05 



66-67 



ERIC 



NEXOP (A, 10) This array is used by the GROW section of 

METAPEX to indicate those exofirms desiring to 
locate in the area in each of the 10 cycles. 
Each column of the array represents a single 
cycle. The four elements NEXOP(l,i) tlirough 
NEXOP (4, i) constitute an array of 64 consecutive 
bits which are set on (1) by the ISET routine 
for those exofirms desiring to enter. Only 
six may be so set for any one cycle. All other 
bits are set off (0). They are tested in GROW 
by the ITEST routine (an alternate entry point 
in ISET). 

NUMEX The count 'in any single cycle of the number of 

exofirms which did enter. 

NEXAA(6) ' The number of the analysis area in which the 

firm in the corresponding element of NEXIN lo- 
cated. 

NEXIN(6) The numbers of the exofirms which entered in 

a cycle. 

For example, if NEXIN(l) = 12- and NEXAA(l) ^ 
17 it means that exofirm 12 located in analysis 
area 17. 

EX0UT(4) A 64 bit vector, cleared at the beginning of 

GROW, in which the corresponding bit is set on 
by ISET for each exofirm which does not enter 
in a cycle. 

EXTHS(4) A similar vector of bits containing a bit set 

on for each exofirm which entered in the current 
cycle. It is the same information as that in 
NEXIN but in a different form. 

EXIN(4) A vector of 64 bits which is cleared only at 

cycle zero and has a bit set on for each exo- 
firm entering during a. game. In other words, 
a cumulative record of all exofirms which enter- 
ed during a game. 

1A1RQ(2) Bit corresponding to Analysis area set on if 

flagged for air pollution headline in newspaper. 
Set in AIR. 
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Notice that each of the above arrays is explicitly defined as intoger *2, 
An integer *2 array, EXBIT (12), is also defined in GROW and the above arrays 
are equivalenced as follows: 

(EXBIT (1), EXOUT (1)), (EXBIT (5), EXTllS(l)), (EXBIT (9), EXIN (1)) 
M,E,T.R.Q."APEX File 513 

(Note: in the IBM 1130 version of METAPEX each record of this file was 
a third physical record in each logical record of file 1 only. It was nado a 
separate file to facilitate the copy operation.) It is used only during, the 
processing of the ''current'' cycle of the game but is retained in data sot 15 
until the beginning of the next cycle for possible error analysis. 
Word Type Name 

1-154 I OFRC (11, 14) Property (units for 1-5 and lOths of acres 

for 6-11) offered by the game realtor and 
industrialists in the AA in current cycle. 

155-308 I SORC (11,14) Property (analogoXis to OFRC) actually sold 

by the game realtors and industrialists. 

309-319 I FOVER (11) Corresponds to the 5 developed residential 

zoning categories, plus six endogenous com- 
mercial/industrial cl ass ificat ions • This 
array is used only in SELL and represents the? 
unfilled demand for land (in lOths of an acre) 
after all "cascading" or pre-empting of land 
by higher use types on the first four itera- 
tions. 
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lK€€Ld Main 




/ 





— > 



'cyclic. Hii^ttttpcr 




No 





.^o r rvi a • lo 



CALL 1 










CALL V 








f 


1 e./VLL 




pfTXvis 1Vl<iiA6T- 




Cordis 



f^lfti ii Pliny 



General Flow Chart, Pai-t 
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CALL GMW 
eto^*^^ dec- 



iLL proi 

Set \or 



ERLC 



CALL S£LU 




CAU- BKVAL 



CALL TRNf T 
»<3^iiBi 1 •turn ctiuh 



1 



CALL BPMIL 
Proc^i rrfvr- 



CAUL CPL 



Procffss pets. 
8c Ityuoi^^rS^ s 



Caul apcq 



Process AfCO 




CALL UPMd^q 



CAU LDMOC 




CALL CKiDoB 



Bctosip 4^ofor% 




General Flow Chart, Part: 2 



Appoiuiix A (nyUii) 




'^0 ' Pol* V'cifcft*! 



CALL PLMOA 



CALL OPISXP 



I 



CALL FIMAM 
%i Jiett* retire 



I 





PlawAers 
Social Tm^ic- 




CALL MftRKi 

Prirt-V 'Special 



CALL SOtM. 



Pri«4 



I 





Set W|0 tc- <;tjt,'( 




No ci- 



£L£CTU»J; 
r€9jd C€M 




Rum ci6^tijiij^ht 



$e4 lA/P c^ll (frc- 
issues -f**"" 



CALL P^/^WS 



General Flow Chart, Part 2 
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INSTRUCTIONS TO COiMPUTER OPERATOR 



Computer Operator 



Game Director 

Team Number , Cycle Number , Date Received 

Instructions for Main Header Card : 

NEWGAME, (Check, only one of the four options and fill in number 

CYCLE , if appropriate.) 

REPEAT , (Underline cycle 0 if desired — only preceding NEWGAMK ) 

NEWSPAPER, [CYCLE Oj 



DATE 



/ / 



(to be printed on output) 



Team identification for page headings (required only if change from preceding 
cycle.) 



Program Control Card Options; 



NOPLAY - DEV(l), 
DEV(2) , 
DEV(3) , 
DEV(4), 
UEV(5) , 
DEV(6) , 
. DKV(7), 
ALLDEV, 



IND(l), 
IND(2) , 
IND(3) , 
IND(5) , 
IND(6) , 
ALLIND, 



(Check as appropriate. All are considered 
playing unless checked) 



SUPPRESS=APCO, DEV(l), DEV(2), 

_DEV(7), 



DEV(3), DEV(4), _ DEV(5) , _DEV(6) , 



IND(l), _ IND(2), IND(3), _ IND(5) , IND(6) , 

POL(l), Central City Politicians 

P0L(5) , County Politicians 

PLANNER(l) , Central City Planners 

PLANNER(5) , County Planners 

DIST, Special Percent Distribution of Land Tables 

SUMMARY, All Summary Tables 

NEWS. 

DATA, List of Data Input Cards (errors. will be printed) 

(All of the. above will be printed unless suppressed. 
=ALL, To suppress all of the above printing. 



MA/360 -2 



PRrNT=l^0I.(2) , Suburb ^ 
V0LO)y Township J [ 
I'OL (4) , Township 2 

PLANNER (2) , Recommendations for Suburb 

PLANNER (3) , Recommendations for Township i 

PLANNER (4) , Recommendations for Township 2 

TOMMSTART, Diagnostics 

TOMMEND, Diagnostics 

(None of the above will be printed unless checked.) 

(Printing of diffusion output for all AAs. 
Diagnostic output for operator. Suppressed 
unless checked.) 

(The following options apply to newspaper and issue processing but must be 
included with main program control cards.) 

ELECTION 

CEM=DIAGNOSTICS, RESULTS, (Diagnostic results; does not effect 

printing in newspaper.) 

BYPASS^CYCLEONE, 

LINKS, 

NATIONAL, 

LOCAL, 



Options for XX card following main player decision cards : 

Normal — stop if errors in data cards, go on if no errors (I-l = blank) 

Stop unconditionally after reading data cards (1-1= -1 negative) 

Go on even if there are errors in data cards (1-1= 1 positive) 



Newspaper Header Card ; 

Number of copies of newspaper desired: COPIES= , 

IGNORE Ignore missing Issue decisions 

NOHEADS No special headline cards in input deck 

REREAD Applicable only in conjunction with NEWSPAPER on Main Header Card. 

Read hew issue (and, if ELECTION specified) candidate decision 
cards even though newspaper has already been printed. If REREAD NOT 
specified an exact copy will be printed. 



DIFFUS=ALL 

AUTUMN, 
WINTER, 
SPRING, 
SUMMER, 



MA/360 

Game Director o r Operator additions to Main t^lajrer Peels ion Cards : 
Change U.S. Employment Growth Rate Percentage: 



Type 


Percent 


Col. 1-2 


F-1 


EG 





FORCE EXOFIRMS: 





Code 
cols 
1-2 


Exof irm 
Number 
I-l 


Force in 
to AA number* 
1-2 




XF 






XF 






XF 






XF 






XF 






XF 







*If 1-2 field blank, will force into exofirm's first choice of AAs 



ADDITIOML EXOGENOUS EMPLOYMENT 



Code 


Analysis 


Type: 


Number of 


No. of 


Added Tax 


Cols. 


Area 


l»Manuf » 


Employees 


Acres 


Base - $ 


1-2 


I-l 


2=Bur 
1-2 


F-1 


F-2 


F-3 


EE 












EE 












EE 












EE 












EE 













ENTER BACKGROUND POLLUTION LEVELS: 



Code 


Season 


Particulated 




CO 




HC 


Cols. • 


I-l 


F-1 


F-2 


F;-3 


, F-4 


F-5 


BP 


l=Winter 












BP 


2=Spring 












BP 


3=Summer 












BP 


4=Fall 













MA/iW) 



OVERRIDE AUTOMATIC DIVIDEND CALCULATION: 





Code 


industrialist 
Number 
I-l 


Dollar amount of Dividends 
to be deducted 
F-1 


DV 






DV 






DV 






DV 






py 







CHANGE INDUSTRIALISTS" AVERAGE ANNUAL WAGE SCALE: 



Place the amount of new annual wage in F-4 field of the PL card 
for the appropriate industrialist. 

CHANGE STATE EQUALIZATION FACTOR (for assessment): 



Code 


Jur isdict ion 


Assessment 




(1-4 only) 


Proportion 




I-l Field 


F-1 Field 


AC 







CASH TRANSFERS TO OR FROM OPERATOR: Operator code is 99 





Code 


To whom 
I-l 


For Whom 
1-2 


Amount 
F-1 


CT 








CT 








CT 








CT 









SPECIAL GRANTS : 



Code 


Jur isdiction 
I-l 


Budget 
I-l 


Amount 
F-1 


SG 








SG 








SG 








SG 









Budget: 1 = General Operating 
2 = Capital Fund 



MA/360 



FEDERAL AIR POLLUTION CONTROL GRANT: 



Code 


Cols. 


Current Cycle 


Next Cycle 


Cycle after next 




3-6 


F-1 


F-2 


F-3 


BR 


0003 









